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ABSTRACT 



The develocment and i mol ement at i on of refresh graphics 
software for the Vector General Display System on a PDP-11 
minicomputer is discussed. Modification and expansion of 
existing software routines* along with additional software 
design and development is presented. As an addition to the 
existing C programming language* a version of BASIC was 
implemented as a second 1 anouage capable of utilizing the 
Vector General software. The unsuccessful implementation of 
a version of FORTRAN with the display system software and 
the problems involved are discussed. Conclusions and 
recommendations are offered* and a detailed user's manual is 
appended . 
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I . INTRODUCTION 



The Vector General Graphics Display Unit in conjunction 
with the PDP-11/50 minicomputer provides the Naval 
Postgraduate School Ccmouter Laboratory with a sophisticated 
t h ree-a i mens i one 1 graphics display system. Hardware 
facilities provide for three-dimensional rotation, 
translation, and scaling of graphics data. Deoth-cueing is 
accomplished by varying object intensity. A circle/arc 
generator, in addition to a vector and character generator, 
further enhances the system by allowing the user to draw 
arcs and circles with specification of only two or three 
points. Additionally/ external devices in the form of an 
alphanumeric keyboard/ liahted function switches/ control 
dials/ trackoall/ joystick/ and lightoen provide interactive 
control of the display presentation. 

Integral to the operation of the Vector General is the 
display controller. The display controller is a processor 
which receives data from a display list/ decodes the data 
into graphic commands/ and activates the appropriate 
generator to cutout the desired information. The 
construction and maintenance of the display list is 
accomplished through the use of the Vector General Graphics 
Li Drary. The 1 iorary functions as the interface between the 
user and display controller. Simple primitives are provided 
allowing the user to build the display list. Additionally/ 
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the software allows the ai sol ay controller to communicate to 
the user information obtained from external devices which 
may be used to orograma t i ca 1 1 y control the display 
present at i on . 

Previous thesis work by Thorpe [11] [12]* Visco [15]* 
and Stankowski CIO] provided fundamental graphics software 
and should be consulted for oriqinal desiqn considerations. 
The objective of work described in this thesis was to 
review* modify* and extend orevious work to provide more 
useable graphics software for the’Vector General Display 
System, To this extent certain goals were set. All 
previous work was to be reviewed* revised and updated. A 
significant portion of time was to be spent in testing and 
debugging previously untested routines. The design and 
i mo 1 emen t a t i on of software to support the trackball* 
joystick* and lightpen facilities was to be undertaken. 
Extension of existing routines to simplify their application 
had to be accorro 1 i shed . Expansion of application languages 
which support vector graphics to include BASIC and FORTRAN 
was seen as a most significant goal of the research. The 
culmination of the study was seen to be the compilation* 
testing* and evaluation of all existinq and newly generated 
software* and the incorporation of all relevant information 
into one user-oriented reference manual. 
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II 



BACKGROUND 



As most of the work discussed in this thesis concerns 
modifications and extensions to previous thesis work, a 
descriotion o * orior work is, in order. Thorpe and R a e t z 
til] [12] designed the original data structures for 
constructing and maintaining the display list. The display 
list was constructed by a series of subroutine calls which 
oroduced the correct seauence of qraphic commands resulting 
in a picture generation. 



The 


display was constructed on 


three hierarchi 


c a 1 


levels: 


oicture/ object/ 


and element. 


An element is 


the 


sma 1 lest 


oicture seamen t 


that can 


be 


referenced. 


It 


consists 


of a seauence 


of move/ 1 


i ne / 


a rc / circle/ 


and 


charac ter 


commands. An element must be 


associated with 


an 



object before it can be displayed and an ooject may comprise 
a maximum of 10 elements. A oicture refers to all the data 
displayed on the screen and may consist of uc to 10 objects. 

Visco 1 1 5 1 was concerned’ with the design of a multi- 
orocessor system to support real-time interactive graphics. 
Due to the high priority of direct memory access (DMA) 
requests necessary to support refresh graphics/ the multi- 
processor conf iguration was envisioned as a solution to the 
DMA bus tie-uo problem. Previous work done by Thorpe and 



Raetz was modified by Visco to conform to the 



envisioned 



system 



Stankowski (10) expanded upon previous work bv al lowinq 
the user to construct elements and objects with alphanumeric 
names replacing the previous numbering convention. The 
object "TREE" could now contain elements "branch! " through 
"branchlO". Additionally/ Stankowski designed a number of 
routines for the user to more easily construct a display 
list. 

O’Dell (5) accomplished the implementation of a 
segmen t ed-o r oces s memory management UNIX operating system 
that had been previously designed by Emery (3). 
Additional lv/ design and implementation was done in a dual- 
ported memory environment where designated portions of core 
were sharabl e regions. O’Dell's work helped lay the 
groundwork for a more generalized system in which additional 
languages could support graphics programs. 

Previous paragraphs have presented work completed prior 
to the commencement of research reported in this thesis. 
The adeauacv of the interface between the user and Vector 
General was still in doubt. Software for the trackball/ 
joystick/ and lightoen facilities was missing and routines 
for other external devices were not readily useable. 
Although routines were present to construct and maintain the 
display list/ the majority of them had not been tested. 
Compatability with O'Dell's SSUNIX and expansion of 
available I anguaaes beyond the C language had yet to be 
accomplished. With this in mind/ a description of the 
modifications and enhancements to the system is presented in 



the 



f o 1 lowing 



sections. 
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III. LANGUAGE EXPANSION 



A. GENERAL 

In review i n a the Vector General Display System and the 
Naval Postgraduate School Graphics Laboratory f it was noted 
that most of the software was written in C programming 
language. This circumstance demanded that any further 
language introduction would reauire compatability with C and 
the UNIX PDP-11 operating system* Two languages became the 
focus of attention due mainly to their wide use and apparent 
ability to call C subroutines. Versions of BASIC and 
FORTRAN were chosen as the languages to attempt 
implementation with the Vector General software. As work 
progressed on these languages/ strengths and weaknesses were 
notea for both that could effect further development and use 
throughout the Graphics Laboratory. The following two 
sections will explore each languaae/ their origins and 
difficulties in development/ and implementation. 

B. BASIC 

1 . Bac kground 

In previous work/ Robertson [ 9 ] implemented an Extended 
BASIC compiler, BASIC (Beginner’s A1 l-ouroose Symbolic 
Instruction Code) was originally developed at Dartmouth 
College and has undergone many changes to suit user needs. 
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The extensions implemented by Robertson include such items 
as string man i pu 1 a t i on , sequential access to external files, 
multi-dimensional arrays, logical operators for numeric and 
string auantities, and the ability to call C subroutines. 

The Extended BASIC compiler, hereafter referred to as 
simply BASIC, is not a ourely interpretive compiler. It 
generates an intermediate code (POP-11 assembly language) 
from the BASIC source program. BASIC object modules and C 
subroutine object modules are able to be linked together. 
One final link and load operation provides the ultimate 
interface between the two different 1 anquage modules. 

The first step in understanding BASIC was to follow the 
operation of the shell command which controls the 
compilation, assembly, and linking. This shell command, 
LBAX, is a user-accessible executable command on the Naval 
Postgraduate School's UNIX PDP-11 file system. The command 
goes through three phases of operation, all of which depend 
on the option codes included (switches set) when the command 
is issued. The first phase is the compile phase. This 
phase compiles the BASIC program source code and emits a 
PDP-11 assembly language file as the output. The second 
phase causes the assembly of this assembly language file 
using the UNIX assembler command "as”. This assembly emits 
an "a. out" file for use in a final linkina and loading 
phase. The final phase uses the UNIX system loader command, 
"Id", to link and load all necessary object modules. The 
LBAX shell command automatically loads the respective BASIC 
and C libraries to reconcile all undefined references. The 



output of this final link and load ohase is an executable 
"a. out" file. Within this final stage of the LBAX command, 
an option is invoked to regulate the UNIX loader. This "-X" 
switch option causes all C internally generated labels to be 
disregarded while retaining only those symbols local to the 
routines themselves. The same switch is also used in the 
loading phase of the C compile shell command " cc" . 

Provisions in the compilation phase of a BASIC program 
ensure the emission of the proper assembly language code 
that allows interaction between the BASIC program and the C 
subroutines. Prior to the actual call to a subroutine, the 
"extern" statement causes the declaration of C subroutine 
ana the designation of the type and number of parameters to 
be passed. The call to the subroutine is done by the "call" 
statement. The name of the subroutine and the actual 
parameters passed are included within this statement. 
Provisions were also made to allow the user to assign return 
values from the suoroutines to predefined variables. 

Initial investigation into Robertson’s BASIC compiler 
proved that the compiler has the capability to allow BASIC 
programs to call C 1 anauaae subroutines. Robertson’s 
Extended Basic Users Manual should be consulted for further 
details concern ina usage. 

2. Testing and Implementation 

Robertson indicated that Extended BASIC could interact 
with subsystems presently used at the Naval Postgraduate 
School Graphics Laboratory. Implementation of this language 



with the Vector General software was never accomplished by 
Robertson, but the basic feasibility of implementation did 
exist. The first tests attempted in this development were 
conducted to determine the correctness of calling C 
subroutines from the BASIC program. Problems arose in the 
passing of floating ooint oarameters. In order for such 
parameters to be passed and aligned correctly within core 
for the C subroutines, the values expected by the C 
subroutines had to be declared as double orecision variables 
within the calling program. C 1 anguage conventions expect 
both floating ooint and double precision variables to be 
stored in 64 bit fields. By declaring the floating point 
parameters as double precision within the "extern” statement 
of BASIC, the problem was overcome. Upon the completion of 
successful parameter passing between BASIC and C 
subroutines, continued testing was undertaken to use BASIC 
with the Vector General Library in drawinq pictures on the 
Vector General display. 

Since development of the Extended Basic compiler and its 
accompanying software, the Graphics Library was physically 
relocated within the UNIX file system. M any of the special 
device libraries were also renamed. The L8AX shell command 
nad to be updated to reflect these changes. An updated copy 
of the source and executable versions of the special device 
libraries were placed on the system for general use. 

In preparing a BASIC oroqram for execution envoi vinq the 
Vector General display, differences were noted in the format 
of BASIC and C programs. The C program contained, as its 
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first orogram statement < an "include" statement. Thorpe 
[11] and Stankowski [101 reauired this statement to load the 
initilized display list in the> proper sequence. The 
position of this statement in the program ensured that upon 
compilation, the display list would be located at the 
beginning of the process's data segment in core space. The 
start of the display list could be located for refreshing by 
knowing the position of the process's data segment. 

The compilation technique mentioned in the preceding 
paragraph is an imcortant design item in Visco's Vector 
General device drivers [151. when designing the device 
drivers, Visco had to ensure that the start of the display 
list could be easily located. He also wanted to ensure that 
•with a snarable core region, the only segment of the process 
located within this region was the data segment. By 
compiling a C Vector General orogram with a " - i " switch set, 
the file aenerated for execution is designated a 411 
filetyoe. This executable file is distinguished in that the 
text and data segments reside in separate address soace (81. 
Upon execution, the start of the aata soace is alianed at 
the beginning of a 32 K word boundary in core. The refresh 
cycle is accomplished by repeated execution of the display 
list which begins at this 32 K word boundary. 

Two major problems had to be overcome in order to use 
the Vector General aisolay with a 8ASIC orogram that called 
C suoroutines. Unlike C, BASIC made no provisions for an 
"include" statement. BASIC would have to cause the loadina 
of the initialized display list by some other means. A 
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concatenation of an initilization list could not be appended 
to the beginninq of the BASIC oroaram because of the failure 
of the language to recognize certain key characters within 
the list. Such characters as the M <- " or underscore 
character* often used within C variables* are unrecognizable 
and return error conditions. A decision was made to call a 
dummy C subroutine which would cause the loading of the 
initialized disolay list in the prooer sequence. Such a 
change demanded a modification of the technique by which the 
Vector General device driver locates the display list data. 



Visco's temoorary 


drivers 


n ad 


to be 


modified to 


find 


and 


communicate the 


offset 


o f 


the 


disolay list 


f r om 


the 



oeginning of the data segment. 

The second major oroblem that was encountered in 
develooment of BASIC was the inability of BASIC programs 
with C subroutine calls to be designated as 411 filetypes 
uoon compilation. The standard file emitted after a BASIC 
compile was a 407 filetype* text and data being mixed within 
the file. ^o provisions were made in the L8AX shell command 
for inclusion of the M - i " switch to split instruction and 
data space ( I & 0 space )• When the loading phase of tne 
shell command was changed to include this option* execution 
of the final executable object module proved unsuccessful. 
As no provisions were made in the compiler to cause data and 
text instructions to be placed on separate stacks* the 
passing of various parameters to C subroutines was unable to 
oe accomplished correctly. It was realized that changing 
the BASIC compiler to emit the proper intermediate assembly 
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language code was beyond the scope of the original intent of 
this research. 

A different accroach was taken in an attempt to overcome 
the problem. This approach involved imclementing a newly 
constructed UNIX operating system which used a segmentea- 
process memory manager in conjunction with previsions for 
shared core regions. The shared core regions were recently 
installed in the hardware. O'Dell C 5 3 implemented such a 
system called SUN IX for the Naval Postgraduate School 
Computer Laboratory. One version, SSUNIX, was implemented 
for the PDP-11/50 processor for use with the graphics 
aisolay equipment. Although not operational, this hybrid 
UNIX operating system was planned to be implemented in the 
computer laboratory. In discussions with O’Dell, SSUNIX was 
described as a solution to BASIC's problem of intermixing 
text and data instructions. SSUNIX could distinguish and 
properly execute either the 4 11 or 407 f i 1 e t y d e processes 
within the shared memory region. The generalization of the 
Vector General device drivers and the proper interface 
between the drivers and the SSUNIX system would be the final 
items to reconcile in completing the implementation. 

Through much testing and debugging, BASIC was 
implemented as a second high-level programming 1 anguage for 
use with the Vector General Graphics Display System. 
Portions of SSUNIX had to be modified to effect this qoal. 
All documentation for changes to SSUNIX and the Vector 
General device drivers are discussed in following sections. 
The use of BASIC as a Vector General programming language is 
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presented in A o o e n d i x A of the Vector General User’s 
Reference Manual. 

C. FORTRAN IV-PLUS 

1 . Bac kg round 

Much of the work in at temot i nq the implementation of F 4 P 
(FORTRAN IV-Plus) with the Vector General software was 
similar to work accomc I i shed in the BASIC implementation. 
FOP did require several different techniques for 

development. More development work is needed before FOP can 
Decode completely integrated with the Vector General 

software. 

FOP was developed for the Digital Eauipment Corporation 
[21 by the Commercial Union Leasing Corporation (CULC) to Oe 
implemented under the UNIX operat i nq system. The Naval 
Postgraduate School received executable versions of the 
comoiler but had no access to the source code for it or 
associated software. This associated software included 

files for converting reaular object modules into FaP object 
modules^ files for clacina F4P object modules into library 
format# and files for linking F 4 P object modules together 
into an executable ooject module. Source code and 

documentation were not available during the development time 
frame; this lack of documentation and source for F4P and 
associated routines made it very difficult to completely 
develop F4P*s use of the Vector General software. 

The task of implementing F 4 P to call C subroutines 
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proved to be quite different than that of the BASIC and C 
integration. Such an implementation will reauire more 
research and testing before it is fully accomplished. Two 
important items of information were known about FaP and its 
associated software. Fup uses "DEC standard" object 
modules? these are quite different than the C object 
modules. Also* prior to use, C object modules would have to 
be converted to FaP readable object modules. 

Two software items were available which were advertised 
to allow FaP oroarams to call C programming language 
subroutines. The "conv" command could be used to convert a 
C object module into an FaP readable object module. With 
all current Vector General software written in C, separate 
libraries made up of the converted C object modules would 
have to be constructed. The "cal lc” routine was the second 
item designed to comolete the interface between the FaP 
program and the C subroutine. This routine stacks up 
parameters for C subroutines, executes the external C 
subroutine, and returns to the callinq FaP program. 

Differences that did not exist in the BASIC 
implementation were encountered in the calling of C 
subroutines by FaP programs. All C subroutines had to be 
separately compiled by the C compiler into object modules 
prior to conversion. The FOP "linker" prohibits 
concatenated subroutines from being compiled together and 
properly linked with the callinq FaP object modules. Also, 
as previously mentioned, the C subroutine object modules had 
to be converted to FaP readable object modules by the "conv" 
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command . 



The software that would allow the communication between 
FUP and C subroutines is the ” c a 1 1 c M routine. The source 
for this routine is an Mil assembly languaqe routine which 
had to be assembled by the Macro assembler. This Macro 
assembler is one of the executable files which was included 
in the associated software supporting the F4P compiler. The 
resulting " c a 1 1 c . o b j " and a seldom used "callcv.obj" modules 
orovide tine user with the facility to place the parameters 
to be passed to the C subroutine in a stack and to jump to 
the C subroutine which is called. The completion of the 
subroutine allows control to return to the F4P calling 
program. The "callc.obj" module would have to be included 
in the link phase of all the modules in order to obtain an 
executable F 4 P file. An important feature of the "callc" 
routine is that it works with pointers to the parameters 
rather than the parameters themselves. This C parameter 
representation necessitated chanqi ng the C subroutines to 
expect pointers to the Parameters instead of the values of 
the oa rame t e r s . 

In dealing with the requirement for separate compilation 
of subroutines and the call by name parameter passing/ a 
separate Vector General library was needed to accomplish the 
task. The "libr" command would have to be utilized to place 
the moaules in a single library similar to the archive 
command " a r " within the C language. Each Vector General 
Library subroutine had to be updated to reflect the passing 
of L-values and then recompiled. After conversion of the 
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object modules into F4P readable object modules/ the modules 
would have to be olaced in a new F4P Vector General Library. 
The following section will discuss the testing and attemoted 
implementation of F4P as a third language capable of using 
the Vector General software* 

2. Testing and Implementation 

After general tests were conducted and proved the 
ability of F4P to correctly call C subroutines/ test ina was 
conducted on a simple F4P program that would use the newly 
constructed Vector General Library of F 4 P object moaules* 
Two non-f atal errors continued to arise in the testing runs. 
The two C library subroutines/ " ecvt H and w f c v t " / were 
described as multiply defined in the error listing. Upon 
review of the source code listings for the two items/ it 
became evident that four different assembly lanauage 
suoroutines were involved: " e c v t H / ” <- f c v t " / "ecvt"/ " f c v t " . 
F4P does not recognize the or underscore character/ but 
unlike BASIC/ it disregards the symbol entirely. Through 
continued testing/ the non-distinction between the two 
similar pairs of subroutine names was found to be no 
detriment to program loading and execution. Correction of 
this problem would recuire rewriting the C subroutine calls. 

A second error of some significance was found while 
test i no proceeded. According to C programming lanauage 
documentation (71/ C allows a user to assign a floating 
point value to an integer variable. Such an assignment 
performs truncation towards zero on the float ina point value 
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and assigns the whole number value to the integer variable. 
An inconsistency was found in the methods that C and F 4 P use 
in the truncation of floating point numbers. 

The converting command "conv" was found to change this 
oasic coding seauence to a sequence which placed the 
truncated floating point value into a long integer with a 
length of 32 bits. Such a chanqe would/ in effect/ cause 
only the ucoer 16 bits of information to be used. To remedy 
the situation/ without beinq able to physically update the 
source code of the convert routine/ all instances of such an 
operation would have to be located and corrected within the 
C subroutine. Each instance was changed to reflect that the 
integer variable was a temporary long integer variable. 
This was immediately followed by the long integer variable 
Deing assigned to a 16 bit integer. The chanqe was proven 
effective and was instituted in the F 4 P Vector General 
Library for the 11 vgab sc a 1 e " / "vqrelscale"/ and "vqpscal" 
routines. 

After continued testing/ one final/ fatal problem was 
discovered with the interaction between the F 4 P and the 
Vector General software. When Vector General subroutines 
are converted into F4P readable object modules/ certain 
switches are set by default. These switches govern the 
overlay use in the "linker” phase ana the global recognition 
of different seaments which are chanqed to "psects". It 
becomes possible for more than one copy of global variables 
to exist. In check inc the display list located in core/ two 
separate display lists were found to exist/ each containing 
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information not held by the other. Information necessary 
for refreshing the disolay list was inaccessable to the 
device drivers. In short# one complete uodatea disolay list 
did not exist. 

The inability to implement F4P as the third language 
capable of utilizina the Vector General Graphics Display 
System was not the result of any one item. The lack of 
source code for the software# poor documentation on F4P 
accompanying software# and inherent differences in the 
structure of C and FUP were all contributing factors. The 
implementation of FUP in the Vector General environment 
should oe Possible by obtaining Drooer documentation. The 
final hurdle to overcome would be the problem of multiple 
cooies of the display list. Recommendations for future work 
in tnis area will be made in the final chapter of this 
t h es i s . 
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IV 



graphics software 



Modifications and enhancements to graphics software fa)l 
within three categories: external device interfacing, 
display list supporting software, and general system 
improvements. 

A. EXTERNAL DEVICE INTERFACING 

The external devices may be used to o rog r ama t i c a 1 1 y 
control the display presentation. Alphanumeric, analog, 
logical, positioning, and lightoen data may be returned to 
the user's program through the graphics routines. 

1. Keyboard 

Alphanumeric data entry is accomplished through the 
Vector General keyboard. Depression of any key enters an 8 
bit ASCII character code into the keyboard register and sets 
the priority interrupt reauest indicating a character has 
been entered. Upon executing the interrupt handler, the 
character code is placed in a keyboard buffer to await a 
call from the user's proaram. The "cget" routine was 
designed to return the data entered from the keyboard. The 
M cget" routine buffers the data until a carriage return is 
received, whereupon the entire alphanumeric string is made 
available to the user's program. The buffering of input 
data was desianed to allow erasing of erroneous data. As no 
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data is avai 1 aol e to the user’s program prior to a carriage 
return, incorrectly entered data may oe removed by repeated 
control-a keystrokes. 

The "cget" routine solved the requirement for returning 
alphanumeric data strinas to the user’s program. 
Determination of integer and floating point numbers, 
however^ presented an additional Problem. Recognition of 
integer or floating point numbers f rom a character string 
requires the conversion of ASCII data to numerical data. 
The svstem-resident C library contained two routines/ ,M qeti" 
and "getf"/ which accomplish the desired ASCII to integer or 
float conversions. Use of the system routines was judged 
more desirable than inventing new software. 

Two new routines, '’feet" and H i get M / were written which 
set condition flags and pass control to the system "getf" 
and "get i M routines to accomplish the conversions. A new 
"getchar' 1 routine was written to replace the system-resident 
"getchar" routine. Ucon executing either the "getf" or 
"qeti" routine, a call is made to the new "getchar" routine 
to obtain a character. Normally/ the default input device 
would be interrogated for the desired character. However, 
due to the condition flag set in the orevious execution of 
the "fget" or "iget" routines, the "getchar" routine 
reauests the character from the Vector General keyboard. 
Repeated calls to "getchar" are made by the system "geti" 
and "getf" routines until a carriage return is received. 
The routine determines the integer or floating point number 
it has within its ASCII string and returns that number to 
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the calling routine* The result is that the user is able to 
obtain integer or floating ooint numbers from either th$ 
console or Vector General keyboard without an excessive 
amount of additional software* 

2 . Function Switches 

The 32 lighted function switches orovide for loqical 
true/false information to be available to the user’s 
program. Three routines were added to enhance the use of 
the function switches. The "f s^an 1 ' routine was desianed to 
return the status of the desired function switch. If 
physically depressed/ a logical value of true or one (1) is 
returned to the user. . If not depressed/ a logical value of 
false or zero (0) is returned. 

The "lamp" routine was desianed to light or extinguish 
the lamp of the desired function switch. No dependence on 
the status of the function switch is inherent in the 
operation of the "lamp" routine. The routine can be used to 
light a function switch to indicate that a certain condition 
has been attained. 

The M fstog" routine was designed to further extend the 
ease in utilizing the function switches. The "fstog" 
routine creates the illusion the function switches are 
toggles which flip-flop their logical value as well as their 
lamp status with each depression of the switch. 
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3. Control Dials 



Analog information is made available to the user through 
the use of the 10 control dials* Integer values returned 
from the control dials vary from -2048 to 2047/ the maximum 
obtainable from the 12 bit system register. Floating point 
values returned to the user through the dial routine/ 
however/ vary from -1.0 to 1.0. This range can be easily 
extended within the user's program. Analog values obtained 
through the dial routine are useful for adjusting other 
orogram variables such as rotation rates and translation 
soeeds . 

4 . Trackball 

Previously mentioned devices have no connection with 
* h a t the user is orimarily interested in/ the display 
screen. The trackball is an external device designed to 
provide visual positioning feedback to the user of data on 
the display screen. This visual feedback is obtained by the 
appearance of a small/ blinking cursor on the display 
screen. Movement of the user’s hand across the round/ 
plastic trackoall causes the software-generated cursor to 
move in an appropriate manner. 

The display of the trackball cursor is accomplished in a 
manner similar to other elements. A sequence of commands is 
executed by the display controller which draws a small cross 
at the origin of the X-Y axis. Each refresh cycle the 
trackball’s X and Y coordinate registers are updated and 
used to modify the coordinate axis of the cursor. The 
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cursor is ^oved reflecting any user movement of the 
trackball. To insure cursor display/ all cursor generating 
code is inserted in the disolay list prior to the code for 
any other element. 

Two routines were designed to be used with the trackball 
facilities. The “cursor" routine was designed to activate 
or deactivate the display of the trackball cursor. 
Activation is accomplished by ensuring that the display 
controller executes the cursor drawinq code. Deactivation 
is accomplished by the display controller skiopinq the 
cursor generating code within the display list. The "posit 1 * 
routine was designed to return to the user’s program the 
position of the cursor on the disolay screen. The "posit" 
routine returns a floatina point value of the cursor's 
position within the defined coordinate system and is not 
dependent on the active disolay of the trackball cursor. 

5. Joystick 

The joystick is an external device similar to the 
trackball in that it provides visual positioning feedback to 
the user. Unlike the trackball/ the joystick appears to 
move three-dimensional 1 y . Movement along the Z axis is 
accomplished by variance in the intensity level of the 
blinking joystick cursor. As the user twists the joystick 
knob to move the cursor further Pack into the display 
screen/ the intensity level of the cursor display is reduced 
giving the appearance that it is fading into the distance. 

Joystick cursor generating commands are inserted and 
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updated in the display list just like the trackball cursor 
commands. Both the "cursor" and " o o s i t " routines work 
eaually well for the joystick with the addition that a Z 
dimension is available for the joystick "posit" routine. 
Both the trackball and joystick cursors are useful in 
providing the user with visual feedback to interactively 
position display elements. 



b. Lightoen 

Ahile the trackball/ joystick/ and associated cursors 
provide Positioning information, the lightoen is unique in 
its ability for pointing or identifying a portion of the 
display. The lightoen does not write on the screen, but 
senses light from the display on its Photocell. Not all 
elements drawn on the display screen cause lightoen 
interrupts. An element's lightoen enable bit must be set 
with the "lahtoen" routine or no lightoen interrupt will 
occur. Once the enaol e bit is set and the operator is 
pointing the 1 iqhtcen at a portion of the element/ the 
display controller causes the lightoen interrupt to occur. 

The objective of the lightpen interrupt handler is to 
determine what portion of the display caused the interrupt. 
After appropriate action is taken, the processor is allowed 
to continue what is was executing prior to the interrupt. 
To determine what element caused the interrupt each element 
is given an element number. This element number is 1 oaded 
in a reaister just prior to the actual drawing of the 
element. Upon encountering a liahtoen interrupt, the 



30 



interrupt handler interrogates the element number register 
to determine the element causing the interrupt. Each 
element has a lightoen flag associated with it within the 
data structures. Upon determining the element which caused 
the interrupt the interrupt handler sets the appropriate 
flag and releases the processor to continue what it was 
doing orior to the interrupt. The interrupt handler was 
kept as simple as possible to minimize the amount of time 
the processor must soend on interrupts. 

Two new routines were designed to help support the 
lightoen facilities. The M oenhi t '* routine was designed to 
return to the user a logical true/false reply. This replv 
was in answer to whether a particular element or object had 
generated a lightoen hit. The routine determines which 
element or object is in Question/ checks the appropriate 
element lightoen flag/ and returns the results to the user. 
The routine was made general enouqh that it could check for 
a lightoen hit on an individual element/ an object, or the 
entire picture. 

The H c 1 r h i t" routine was desianed to clear individual, 
groups, or all elements of previous lightoen strikes. The 
routine resets lightpen flags to the clear position in 
preparation for identifying new lightoen strikes. 

Although the capabilities of the lightpen make it an 
ideal device for pointing or identifying portions of the 
display, the inclusion of additional software made the 
lightpen an eoually qood positioning device. 8y including 
additional draw commands in the display list in the same 
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area as the commands for the trackball and joystick cursors, 
a lightpen cursor was made available to the user. The 
lightpen cursor is an octoqon-shaped object which may be 
moved with the helo of the lightpen. The iightpen cursor 
was constructed with eight elements comprising the eight 
sides of the cursor. Uoon approaching the lightpen cursor 
with the lightpen/ the cursor appears to latch on and follow 
the liqhtoen about the display screen. 

The trackina of the lightoen cursor is accomplished by 
aetermining which side of the lightpen cursor first 
initiates a liqhtoen hit. Moving of the coordinate axis of 
the cursor is then accomplished/ minimizing the distance 
between the center of the cursor and the lightpen. The 
determination of the side initiating the lightpen strike is 
accomplished within the interrupt handler. Distinction 
between the sides of the lightpen cursor and other lightpen 
bookable elements is accomplished by providing the lightoen 
cursor with 8 unique element numbers. 

As with the trackball and joystick/ two routines provide 
lightoen cursor oositioning information to the user. The 
"cursor” routine is essential in activating ana deactivating 
the display of the lightoen cursor. Unlike the trackball 
and joystick cursors/ the lightoen cursor must be displayed 
to be updated. The "oosit” routine returns the floating 
point position of the lightpen cursor within the defined 
coordinate system. 
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DISPLAY LIST SUPPORTING SOFTWARE 



In reviewing/ revising/ and extending existing software/ 
many tests and changes were required. The "arc" and 
H c i rc I e” routines were rewritten to provide for correct 
manipulation of associated center and endpoint arguments. 
The "setvector" and "endele" routines were revised to ensure 
proper termination of display list element blocks and to 
correct deficiencies in the generation of auto-increment 
arcs and circles. The "intscale" routine was revised and 
extended to allow the user to specify whether intensity 
cutoff plane orovisions were to be in effect. Changes to 
other routines included additional software to inhibit error 
conditions/ and correlating routines to provide optimal use 
of available display list space. Three routines received 
particular attention and reauire a fuller explanation. 



1 . Remove Routine 

As ori ai na 1 1 y designed the graphic system data 
structures provide for a display list of a fixed length in 
size. Should all the display list be utilized/ no 
additional data would be displayed. For example/ should the 
first element of the first object the user builds use up the 
entire display list/ no additional elements could be 
displayed even though only one element of one object had 
been used. Normally such a situation would not occur; 
however/ snould numerous large elements be constructed this 
same problem/ lack of available display list space/ could 
arise. The H remove" routine was designed to help solve the 
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problem. The user specifies those elements no longer 
essential to the display which can be eliminated* thereby 
creating available space within the display list for 
additional elements, 

A somewhat analogous situation occurs within the memory 
management techniaues of most operating systems. Various 
methods have been devised to recover available memory 
segments and reduce fragmentation. The importance of 
recovering unused or fragmented memory space in memory 
management techniaues cannot be overemphasized. The 
efficiency of the entire system may depend on the judicious 
use of available memory. As the importance of recovering 
available display list space for a process already running 
in memory is somewhat lower than for memory management 
techniaues* a less sophisticated method was designed for the 

i 

" remove " routine. 

Upon receiving a list of nonessential elements from the 
user* the "remove" routine sequentially processes the 
removal of each block of element commands. The freed block 
is burped or bubbled through the display list by movina 
succeeding element blocks up within the display list. The 
movement of element blocks within the display list requires 
the adjustment of address pointers to these element blocks 
to ensure proper operation of the display. As the location 
of active element blocks are moved to free unused memory 
locations* display list refreshing is inhibited during this 
operation. This procedure* though costly in execution time 
for a series of elements* was deemed more suitable than a 
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more sophisticated method which would have cost the user 
additional memory soace. Additionally, this simple 
technique was preferred because the H remove " routine was not 
expected to be used so f reauent 1 y within a program that a 
momentary delay in execution would be noticed* 

2 . Printv Routine 

As criqinally implemented, the graphics software 
provided for only one tyoe of element containing 
alphanumeric data. The M charel e" routine was used to 
specify the contents of the character string which could 
contain any of the characters available in the Vector 
General character set plus a few format instruction codes. 
Provisions for chanai na the contents of an element’s 
character string were nonexistent. 

A search was conducted to determine the most feasible 
way of providing for an element which could handle changing 
character strings and also provide expanded formatting 
capabilities. The success of the M fget" and M iget” routines 
in using system routines focussed attention on the system 
"printf" routine. The "printf” routine converts, formats, 
and prints its parameters after the first argument, under 
control of the first argument. The first argument, the 
format argument, consists of characters and conversion 
specifications. It was felt that a combination of the 
"cnarele" and "printf” routines could expand the use of 
character strings used within the Vector General Display 
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System 



In accomplishing the merger of the ,f p r i n t f ” and 
"charele" routines two new routines were written. The 
H ori ntv" routine contains arguments from both the "charele" 
and "printf" routines. Positioning and character string 
initialization arguments are similar to those in "charele" 
while format and conversion arguments are similar to the 
M p r i n t f " routine. The "or i ntv” routine oasses its format 
and conversion arguments to the system "printf" routine to 
accomplish the actual convert i na and formatting of the ASCII 
character string. As the "printf" routine must call the 
system "outchar" routine to output characters, a newly 
designed "outchar” routine was substituted for the system- 
resident routine to output characters to both the console 
and Vector General disolay screen. 

The ”printv” routine aives the user a greatly expanded 
capability in handling character strinqs. Although the 
"orintv" element reauires additional display list space over 
that of a "charele" element, the expanded formatting and 
conversion capabilities of the " orintv" element, in addition 
to its ability to be used repeatedly for different character 
strings, makes it a highly useful enhancement to the display 
list supporting software, 

3. Disolay Routine 

As mentioned previously, an element-object link must be 
estaolished to disolay elements on the screen. While both 
the M remove" and "erase" routines caused the disappearance 



36 



of an element from the display screen, no routine was 
available to activate or deactivate the display of an 
element without affecting the el ement-ob ject association* 
The "display" routine was desianed to accomplish such a 
purpose. By replacing certain graphic commands within the 
display list with subroutine return commands, the display 
controller may be made to skip execution of an element’s 
draw commands. This effectively deactivates the a i splay of 
the element without affecting the element-object 
associations. Activation of the element is then 
accomplished by reinserting the original commands in the 
display list such that the display controller executes the 
element’s draw commands on the next refresh cycle. The 
"display" routine allows the user to turn an element’s 
display on or off without affecting the necessary element- 
object associations. Thus the number of routines required 
to activate or deactivate an element’s display is less than 
if either the "remove" or "erase" routine had been called. 

C. general system improvements 

M any of the revisions and extensions to system software 
previously mentioned could equally qualify as general system 
improvements as their presence ensures a smoother interface 
between the user and the display controller. Of particular 
concern in this category are the areas of system 
initialization and error diagnostics. 
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1. System Initialization 

The M sysinit H routine is the first graphics routine 
called within a user’s program. The routine was designed to 
estaolish links from the user’s process to the Vector 
General display unit so that refresh data could be sent to 
the display unit and external device information could be 
returned to the user. The presence of two Vector General 
disolay units required differentiation between units. The 
user specifies the desired display unit with the argument 
passed to the "sysinit" routine. To insure maximum 
opportunity for execution of a user’s program, software was 
added that attempts to link a user with the secondary 
display unit should the system be unable to link to the 
user’s primary choice. The user’s process is terminated 
only when the system has failed in attempts to link the user 
with both disolay units. 

2. Error Diaanostics 

Recognizing that users will make errors, the design and 
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extremely forgiving and diagnostically helpful software. 
Recognizing that such a system is not cheap in terms of 
required supporting software, the requirements for a 
reasonaole system of error diagnostics were reviewed. 

It was felt that all detected errors should be 
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identified to the user. Presentation of error diagnostics* 
however* is as important as the actual error detection. 
Cryptic error messaaes with numbers which must be looked ud 
in manuals* do little to helo the user diagnose problems* 
Concise error messages which identify the error* the routine 
where it occurred* ol us give reference to additional 
information were deemed more suitable and could be obtained 
with minimal overhead* 

The error diagnostic routine was rewritten to provide 
the user with four items upon error detection* An error 
type is specified so the user may realize what has caused 
the error. Additionally* the argument in error and the 
routine in which it occurred are specified to ensure that 
the user pinpoints the problem. Should the preceding 
information be insufficient* the last item provided is an 
error number with which the user may obtain a detailed 
explanation of the error from the Vector General User’s 
Reference Manual • 

Graceful error recovery could be considered an art* 
Termination of a user’s program upon initial error 
detection* while easily accomplishable* would tend to not 
only deflate egos but also discourage potential users* All 
software routines were designed and implemented to detect* 
identify* and H araceful 1 y M recover from user errors. 
Although tne detection and identification of errors is 
fairly standard throughout the routines* the recovery 
methods vary from routine to routine. Within some routines* 
default parameters are assumed upon error detection to 
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ensure continuation of the routine 



Other instances may 



occur/ however/ where no default parameter could be assumed* 
In such instances the only form of recovery is to exit t re 
routine and' return control to the user’s program* ftith the 
exception of the "sysini t w routine/ no routine will cause 
termination of the user’s orogram* This was done to ensure 
that some oart of the user's display is presented/ providing 
the user some amount of self-confidence and a starting point 
for using the error diagnostics to oinpoint remaining errors 
in the program. 
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V. MODIFICATIONS TO SSUNIX SYSTEM SOFTWARE 



A. GENERAL 

Investigation was begun into the development of SSUNIX 
to further generalize the use of other languages with the 
Vector General Graphics Disolay System. As a result of the 
Extended BASIC compiler's inability to separate the 
instruction and data segments of an executable file, SSUNIX 
was implemented on the PDP-11/50 A processor within the 
Computer Laboratory. After studying the UNIX and SSUNIX 
systems and reviewing O'Dell's recommendations for final 
integration with the Vector General software, modifications 
were made to complete the implementation. Further 
modifications were made when problems arose in the SSUNIX 
system of core allocation. The modifications made to SSUNIX 
software were in two general areas of the system software. 
Modifications were made to the SSUNIX source code and to the 
Vector General device driver code. 

O'Dell [51 implemented a segmen t ed-p roc es s memory 
management version of the UNIX operating system which was 
previously develooed cy Emery [31. O'Dell also implemented 
an additional version, SSUNIX, which was designed for a 
shared memory environment. The UNIX operating system [6], 
from which the aDove modified systems were constructed, is a 
time-sharing system developed at Bell Laboratories. The 
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UNIX system was currently in ooeration at the Naval 
Postgraduate School Comouter Laboratory on the PDP-11/50 
orocessors. The notable accomplishment of the SSUNIX 
ooerat i ng system is that it aligns a process's data segment 
or combined data and test segments into a region of shared, 
dual-ported memory. The process image is then locked in 
this memory region for execution. 

Prior to O'Dell's accomplishments, Visco [151 had 
sugaested that Emery's original design was a promising 
technique for allocating a Vector General process's data 
segment into a shared memory region. This dual-oorted 
memory region could suoseauent 1 y be accessable by a slave 
processor which would continuously access the display list 
data by DMA (Direct Memory Access). Visco' s slave processor 
design would alleviate the PDP-11/50 bus tie-up problem 
which was caused by the high interruot precedence of a 
refresh cycle. The accessed i 1 i t y of the shared memory 
region by the main processor would provide the real-time 
reaui rements for multiprogramming in the refresh graphics 
environment. Visco believed that by ensuring only data 
segments would be located in the 32 K word shared core 
region there would be greater efficiency and less likelihood 
of having programs too large for execution. 

A <ey factor for the implementation of SSUNIX was its 
propensity to distinguish between processes where data and 
text were separated segments in core (411 filetypes) and 
files where data and text were mixed (407 filetypes). 
SSUNIX causes both filetypes to be loaded into the shared 



memory region and executed alike. SSUNIX proved to be the 
solution to the Droblem of executing the BASIC executable 
object module where test and data reside together. Looking 
beyond BASIC's problems* SSUNIX is of such a general nature 
that other user languages can be more easily implemented 
with the Vector General software. The future integration of 
F 4 P with the SSUNIX system should reguire no further 
moofi cat ions to SSUNIX. 

B. MODIFICATIONS TO SSUNIX SYSTEM CODE 

Moaifi cations to SSUNIX were made in two general areas: 
the interface code between the user and the system software* 
and the correction of the process for allocating core orior 
to locking the process in the shared core region. These 
changes were tested and instituted in the SSUNIX system. 
The nature and explanations for the changes are discussed in 
the following paragraphs in this section. 

The first modification to SSUNIX was the updating of the 
shared memory region parameters located within the "main" 
subroutine of the system. SSUNIX is alerted by "getshr” 
that a shared memory reaion of core is reguested for 
execution of a process. The first oarameter passed to the 
system is the region of shared core that is reguested. 
These regions of shared core are assigned the identifying 
numbers 0 (blocks 2000 - 4000) and 1 (blocks 5000 - 6000). 
Each block of core represents 64 bytes of core space. 
Region 0 is 32 K worcs in size while region 1 is 16 K woras 
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in size. Region 0 was originally declared as 1000 blocks in 
length beginning at block 3000. The size of this first 
region had to be corrected in S S U N I X 1 $ "main” routine. The 
true size of the region is 2000 blocks in length beginning 
at block 2000. 

The second modification to the assembly language code of 
"getshr w was the addition of a oarameter to be passed to the 
system. The parameter oassed is the address of the first 
word of the disolay list. The address represents the offset 
value of the first word of the display list from the 
beginning of the data segment. If the text and data 
segments are not solit* the offset is from the beginning of 
the mixed text and cata. This method identifies the first 
word of the disolay list to the device driver whether or not 
text and data were solit. If I & D soace were split and 
H vgdata" was included at the bed inning of the C program/ the 
offset would be zero indicating that the disolay list starts 
at the beginning of the process’s data soace. Iff as in a 
BASIC process* I & D soace were not solit the offset would 
be added with the offset of the data segment from the 
beginning of the shared memory region. 

Prior to the inclusion of the offset address in tne 
" aetshr" routine* both "getshr" and ’’freeshr” had to be 
introduced into the Vector General Library. The previous 
calls to "rtime" and "nonrtime" under the UNIX system were 
changed to "getshr" and "freeshr” calls. The difference was 
that the shared memory c on f i gu r a t i on of core required the 
Vector General orocesses to reouest this shared core region 
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for loading and execution. 

In order to use the offset value oassed to the system by 
the "getshr" call/ a small routine called "vgdsoff" was 
added to SSUNIX. When "getshr" is called by the Vector 
General user code/ a new variable " f i r s t wdadd r " is assigned 
the value of the the offset of the first word of the display 
list. The "vadsof f " routine returns the value of 
"firstwdaddr" to a calling routine in the device driver. 
The only routine that would call for this value would be 
"vgdev50.c" which is the PDP-11/50 device driver for the 
Vector General Disolay Processor, This offset value passed 
to the driver code is a key factor in allowing various user 
languages to use the Vector General software, without this 
offset/ the ability to generalize the refresh method for 
different languages would be difficult. 

The final modification to the SSUNIX system was the 
result of a condition that had previously gone unnoticed. 
With the help of O’Dell/ the source of an error in core 
allocation by SSUNIX was traced to a routine called 
" m a 1 1 o c " . Tnis routine allocates soace in core to the 
process being loaded by first checking the core "free mao". 
The "free map"/ which is a mapoinq of free core areas/ keeps 
track of the areas of core which are free to be used for 
storage of a process. SSUNIX first swaos a process out of 
core onto disk. The process is then copied back into core 
in an area not within the shared memory region so it is out 
of its own wav. " M alloc" failed to take into account that a 
large free core area could exist from just below the upper 



address of the shared memory region to the too of available 
core area. If the area beneath the shared core region was 
not large enough to store the process^ the next free area to 
be checked would be this large area. This area was 
unavailable for storage as the set flag "sharflg" indicated 
the region was in the shared memory region* As the 
beginning of the area was located in the shared core region, 
the entire area was marked unavailable for process swapoing. 

A routine called " s d 1 i t m a o ” was aesigned ana implemented 
to remedy the problem by updating the core " free map” to 
reflect that the region above the upper boundary of the 
shared core was available for storaqe. "Splitmap” is called 
in the "shalloc" routine just prior to a call to "ceswap". 
"Ceswao" originally called the M m a 1 1 o c H routine to assign 
the core area for temporary storaae. M S p 1 i t m a o ” changes the 
r ep resen t a t i on of the free core region to two free core 
regions which would be separated by the upper boundary of 
the shared core reqion. The area within the shared core 
region would not be used due to the set ’’sharflg”, while the 
area above the boundary would be properly allocated. 

Other core allocation conditions were reviewed to 
aetermine if additional problems could arise. No other 
problems were noted/ and the updated version of SSUMIX was 
found to function properly. 
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C. MODIFICATIONS TO DEVICE DRIVER CODE 



As previously mentioned/ the device driver code for the 
Vector General was modified to allow the execution of 
processes with or without split text and data segments. 
Vi sco designed the original device drivers/ " nvgdev3^.c ,f and 
” n vgde v 5 0 . c " / to suopart the Vector General in a multi- 
processor mode of operation. The two processors were to 
interact in refreshing and updating the Vector General 
display list. Inherent in the design was the assumption 
that all processes would be of the 4 11 f i 1 e t y o e / where text 
and data segments are separated. The data segment would be 
located alone in the sharaole core region. In order to 
discuss the modifications to the drivers/ a brief 
description of each driver is presented. 

The "nvgdev34.c" driver is the proposed PDP-11/34 
resident device driver for the Vector General. It 
communicates to the PDP-11/50 by messages that are passed 
throuqn a hardware interface device called the DR-ll-K. The 
driver is passed several items of important information by 
the message process: the offset of D space within the shared 
memory; the use of Vector General numbers 0 or 1 ; and/ the 
time to begin refreshing the display list. This driver is 
also responsible for handling the interrupts generated by 
the Vector General display controller. 

The "nvgdev50.c” driver is the PDP-11/50 processor 
resident device driver that supports the Vector General in 
the two processor mode. This driver formats and sends 



messages to the PDP-11/34 processor through the DR-ll-K 
device* The messages sent by this driver designate the 
offset of the data space *rom the beginning of the 32 K word 
shared memory region to determine where the disolay list 
begins in core* 

The temoorary device drivers* " t vgdev34 * c " and 
"tvgdevSO.c"* were desiqned to suooort the Vector General in 
a single processor moae* The two drivers were oriqinally 
written by Visco to simulate and test the operation of the 
two orocessor design until the PDP-11/34 processor could be 
installed* Both tempory device drivers will continue to 
drive the Vector General until the slave processor is 
integrated into the system* 

The drivers were cesiqned with two goals in mind* The 
first goal has been ai scussed before. The PDP-11/34 driver, 
as the refresh processor* would refresh the display list. 
The second design goal was that the PDP-11/50 driver had to 
inform the slave orocessor of the location of the display 
list for refreshing purposes. In generalizing the driver 
code these two goals remained oreeminent. The following 
paragraphs document the exact modifications made to the 
device drivers currently used under the SSUNIX operating 
system. 

1. Modifications to TVGDEV50.C 

Only one addition was made to this driver* Within the 
" vgooen” routine* a check was made to determine if I & D 
soace was solit. If it was not split* indicating a 407 



process/ a message was sent to the 34 device driver which 
passed the offset of the first word of the display list from 
the beginning of the process. The message was distinguished 
in the 34 driver from other messaqes by virtue of its sign 
pit being set. The messaae was constructed by setting the 
sign bit for the value returned from the previously 
develocea "vgdsoff H routine within SSUNIX. A return to the 
50 driver was made after the message was processed by the 34 
driver. The use of the messaaes in the 34 driver will be 
discussed in the following section. 

2. Modifications to TVGDEV34.C 

The functioning of the 34 device driver deoends on the 
information passed to it by the 50 device driver. Several 
modifications had to be made to the driver to generalize the 
code for additional language implementation. The first 
modification was the crocessinq of the offset message passed 
by the 50 driver in cases where I £ 0 space was not split. 
This message is received by the " vq34co^ ,f routine and is 
converted to a positive value. A new variable/ 
M s h a r memo f f H / is set to the oassed value. The value of 
"sharmemoff" remains zero if a 411 process is executed 
because the variable had previously been initialized as zero 
and no additional message would have been passed to the 
driver. If the variable had a positive value/ indicating a 
407 process/ the item would be used in the "vaopen" routine 
located within the driver code. Three separate variables 
depend on this variable for determining values that tne 



refresh cycle and the PDP-11/34 memory management operation 
are based on • 

The PDP-11/34 is unable to address items in a user’s 
display list by simply referencing symbol names. It is able 
to address only the 3 2 K words of the dual-ported shared 
memory. 3y using the memory management hardware and the 
message information passed by the 50 driver/ the correct 
physical addresses of the display list items can be located 
in core. The page address registers/ when properly set/ 
allow this mapping or conversion of virtual to physical 
addresses in core Cl]. 

Three variables called "vapar”/ "vgreal "/ and "pp" all 
involve the use of memory management. The " o o " variable is 
a virtual address pointer that can be used in addressing any 
item in the display list which resides in the shared memory 
region of core. This variable can be used to address up to 
4 K words of core which is more than adeauate for addressing 
the several hundred words in the display list that miaht be 
addressed. 

The result of the modifications made to this device 
oriver was the correct refreshing of both 407 and 411 
filetyoe processes. All other added items within this 
driver reflect additional interrupt handling capabilities 
for the external devices of the system. 
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VI. CONCLUSIONS AND RECOMMENDATIONS 



The primary objective of work described in this thesis 
was the implementation of enhanced user software with the 
Vector General Display System. This objective was attacked 
on two fronts. The first approach was to test/ correct/ and 
expand the software creviously available on the system/ 
which would improve user interaction. The second approach 
was to implement other user languages/ specifically versions 
of 3ASIC and FORTRAN, with the Vector General software. 
Together/ the two approaches provided the successful 
implementation of a oackage which better supports user 
interaction with the Vector General Display System. This 
chapter provides further recommendations to improve the 
system in the areas of the display list design/ 1 anguaqe 
development/ and system software implementation. 

A. DISPLAY LIST DESIGN 

In the present design of the Vector General software/ a 
structure within the display list is utilized to store user 
commands to be executed on the Vector General display. This 
structure "vqalbuf" is of a fixed length/ 4 K words of the 
shared memory. An improvement in this techniaue of having a 
fixed length display list could be investigated. One 
possibility would be the implementation of software to 



increase the size of the structure which would utilize the 
unused Portion of the sharable memory region* This software 
implementation would be useful when no other process needs 
the shared memory region and the parent process requires 
additional core space* 

B. LANGUAGE DEVELOPMENT 

F4P (FORTRAN IV-Plus) was not comoletely implemented 
with the Vector General software due to problems encountered 
with the interaction between the F4P and C languages* It is 
recommended that investigation continue in reconc i 1 i na the 
" overlay" problem caused by C converted subroutines having 
more than one copy of alobally declared variables. 
Prereaui site to understanding this problem is the 
acquisition of source code and documentation for the F4P 
compiler, the N conv" subroutine, and the F 4 P M linker" • 
Completion of the the F4P and C interface would further 
expand the utilization of the Vector General Graphics System 
to users with knowledge of other languages. 

The inability of Robertson's BASIC compiler to split I & 
D soace is viewed as a less important problem. SSUNIX and 
driver desian modifications were imolemented to overcome 
execution problems of the BASIC Vector General programs. 
The expense of BASIC's inability to split text and data 
segments required the allotment of more shared memory in 
loading the combined text and data segment. By re-working 
the compiler to allow the stacking of data and text in 
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separate data and text segments* more complex BASIC programs 
could be executed in the shared core region allotted for 
execution. Additional testino of large BASIC programs could 
helo determine the limitations of loading both text and data 
segments into the shared memory region. 

C. SYSTEM SOFTWARE IMPLEMENTATION 

An increasing item of importance to the software 
develooed in this thesis and previous software work is the 
continuing support of the SSUNIX operating system in the 
Naval Postgraduate School Graphics Laboratory. It is 
recommended that increasing emphasis and testina be placed 
on SSUNIX while running in a day-to-day operational 
environment to ensure its reliability. 

The implementation of the PDP-11/34 processor in a 
dua 1 -processor mode with the PDP-11/50 processor should be 
of primary importance for the Vector General Display System 
to alleviate the current bus tie-uo problem. An 
investigation into the communication reauirements between 
the slave and the master processors should be conducted. 
The hardware interfaces for the 32 K word shared core region 
and the Vector General display device should also be 
i mp 1 evented. 
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APPENDIX A 



USER’S REFERENCE MANUAL 



The ouroose of this document is to orovide the user with 
the information necessary to execute programs employing the 
Vector General qraohics display. This manual was originally 
prepared by B. J. Stankowski in June 1976 and revised by N • 
P. Martino and D. C . Endicott in December 1977. 

Section I provides a brief introduction to the Vector 
General display system, the software support library, and 
the orerequi si tes for their effective utilization. Section 
II descrioes the Vector General system in more detail, 
expanding upon the hardware features, system interface, and 
external device capabilities. Section III contains 
information on the initialization of the Vector General 
display system. Section IV describes the display 
composition, element construction, and picture, object, and 
element relationships. Section V provides a brief 
oescription of the user support routines available in the 
support library. Finally, Section VI provides information 
necessary for compiling and executing user programs 
employing the Vector General graphics display unit. 
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I 



INTRODUCTION 



The Vector General is an interactive graphics display 
system which has been interfaced with the PDP-11/50 
computer. The display interacts with a PDP-11 user by 
displaying pictorial information on the surface of a cathode 
ray tube and by accepting information from its external 
control devices. The external devices consist of an 
alphanumeric keyboard; 32 lighted function switches/ 10 
control dials/ a trackball/ a joystick/ and a lightoen. 

An interactive graphics software program library has 
been constructed to interface the user and the Vector 
General display controller. The software package provides 
the user wi tn sufficient routines to easily construct and 
manipulate graphic displays. Although the routines were 
written in C / the user has the choice of two high-level 
languages with which to program. BASIC programs may now 
also interface with the Vector General through the use of 
the routines in the software support library. 

This manual does not attempt to discuss in detail the 
electronic functions of the Vector General/ or its interface 
with the PDP-11. The ourpose of this manual is to instruct 
a user in the creation and manipulation of pictorial data on 
the Vector General display. A knowledge of C or Basic is 
assumed . 
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II 



THE VECTOR GENERAL DISPLAY SYSTEM 



A more detailed discussion of the Vector General can be 
found in the Users M anua i f Q r the Vector General Display 
Unit [12] and the Design Manual for the Vector General 
Display Unit [111, 

A. THE DISPLAY 

The Vector General is a cathode ray tube (CRT) display 
on which a visible Pattern can be created Dy the movement of 
an electron beam. The electron beam causes a florescent 
soot to aooear on the face of the display tube* The 
movement of the beam is controlled by a method called random 
scan , which in effect steers the spot in a straight line 
Detween two points on the display screen* The resulting 
line or vector; combined with others^ creates a picture or 
oattern on the display screen. 

To maintain a clear oicture on the disolay screen 
requires that the oattern be redrawn on the tube repeatedly 
at approximately thirty to forty times a second. Each 
repetition is called a frame and the frequency with which it 
is redrawn is called the refresh rate* If the oattern is 
not repeated often enough a degradation of the picture will 
occur on the display screen. This degradation is called 
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B. HARDWARE FEATURES 



The system has several hardware features# in addition to 
a vector generator# which great I v extend its capabilites. 
These include the ability to produce three-dimensional 
figures# an ASCII character set# and the hardware generation 
of arcs and circles* Other features orovide the hardware 
mechanisms for the rotation and translation of user 
specified picture segments. These hardware features are 
controlled and coordinated by the display controller. The 
controller is resoonsibl e for handling the communications 
between the user# the external control devices and the 
display hardware. 

The main purpose of the external control devices is to 
facilitate user interaction with the display. These devices 
include an alphanumeric keyboard# 32 lighted function 
switches# 10 control dials# a trackball# a joystick# and a 
1 ightoen. 

Additional information on the Vector General hardware 
can be found in the Graph i cs Disolay Reference Manual [131 
and the Graphics Display System Technical Manual (1^1. 

C. THE SYSTEM INTERFACE 

A Vector General user defines pictorial data and its 
manipulation within a Basic or C oroqram. The execution of 
the program causes the Vector General software interface to 
be activated. It is this software which communicates user 
requests and receives information from the Vector General 
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controller. The software oasses user reauests> in the proper 



form, to the diolay controller. The controller will 
activate the orooer hardware generator (ie. character, 
vector, • arc/circle) which will output the desired 
information on the diolay screen. The controller will also 
oass information from the external control devices hack to 
the user via the interface software. This relationship is 
illustrateo in figure A - 1 . 




Interface Relationshio with the Vector General 

FIGURE A-l 



D. INTERFACE rtITH EXTERNAL DEVICES 

Each of the the external devices communicate directly to 
the Vector General controller. Information from these 
devices is returned to the user via the controller ano the 
user interface. The user orogram may utilize the information 
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This 



returned from these devices to control orogram flow, 
allows a user to interactively control and manipulate the 
pictorial information at display time* Specific user 
routines which activate these external devices and provide a 
communications channel with the user are discussed in detail 
in later sections of this manual. 

1. Alphanumeric Keyboard 

The alphanumeric keyboard allows the user to incut 
information in the form of ASCII character codes. Through 
the user interface the user can display the information on 
the Vector General display screen. The data entered from 
the keyboard can also be returned to the user program for 
processing. 

2 . Function Switches 

The 32 lighted function switches provide the user 
with information which can be used to interactively 
manipulate pictorial data at display time. Each function 
switch can be assigned specific meaning by the user program. 
The user interface returns to the user information on which 
function switches have been pressed. A user orogram could 
use this information to selectively rotate* translate or 
perhaps scale particular picture segments. 



3. Control Dials 





The 10 control di 


als provide numeric in 


f o r m a t i on 


t o 


the 


disolav controller/ 


specifying the degree 


to which 


each 


dial 


has been turned. 


This information* 


through 


the 



software, can be provided to the user. A user oroqram may 
utilize the values of the variable control dials in 
determining the distance or rate at which a oortion of the 
oicture may be moved or rotated. 

4 . Trackball 

The trackball is an external device which uses a 
sof tware*generated blinking cursor to provide visual 
positioning feedback to the user. The rolling action of the 
user’s hand across the round trackball steers the cursor 
about the disolay screen. A routine is available to return 
the trackball cursor position within the defined coordinate 
system so the user may orogramatically use this information. 
Additionally, a routine is available to activate or 
deactivate the disolay of the sof tware-qenerated cursor. 
Positioning information may be returned to the user whether 
or not the cursor is displayed. 

5. Joystick 

The joystick is an external device, which like the 
trackball, uses a software-generated blinking cursor to 
provide positioning feedback to the user. Unlike the 
trackball which moves about only the X - Y plane, the joystick 
cursor appears to move in three dimensions. Movement about 
the X - Y plane is accomplished by pushing the joystick fore- 
aft, and s i de - t o -s i d e . Movement along the Z axis 
(perpendicular to the disolay screen) is accomplished 
manually by twisting the knob on too of the joystick and 
visually on the screen by using the deoth-cueing facilities 
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and varying the cursor intensity. Like the trackball/ 
routines are available to return to the user the joystick 
cursor oosition and activate or deactivate the display of 
the cursor. 

6. Lightoen 

The lightoen/ a wand containing a photo cell/ can be 
used to selectively ooint to different oicture segments on 
the display screen. The interface provides a user crogram 
with information on which oicture segment was oointed to by 
the lightpen. A user program can turn the lightpen 
se 1 ec t ab i 1 i t y of specific picture seaments on or off. For 
example/ a user might select sections of a picture for 
erasure by oointing to them with the lightpen. 

The software additionally orovides for generation of a 
lightoen cursor. The lightpen cursor is a small non- 
blinking octagon which mav be moved about the display screen 
with the lightoen. Two soeeds of lightpen movement are 
availaole. Routines for returning the lightpen cursor 
position and activation/deactivation of the cursor display 
are available within the software oackaae. 



6a 



III. INITIALIZATION 



A. INTERFACE INITIALIZATION 



The Vector General display system and the graphics 
software with the PDP-11 must be initialized before any data 
can be displayed. The initialization routine sysinit must 
be called before any other routines are utilized. This 
routine sets all the system default parameters, such as the 
screen coordinate system. 

If for some reason the initialization cannot be 
completed the user crogram will be terminated. This error 
usually occurs because another user is accessing the Vector 
Genera 1 . 



B. DISPLAY INITIALIZATION 



1. Coordinate System 

The user can soecify 
cartesian coordinate system. 



a two or three-dimensional 
All display coordinate values 



referenced by the user will be interpreted according to this 
coordinate system definition. A user may redefine the 
coordinate scale at any time in a program. The user will 
define tne coordinate system in a call to the routine 
coo rdsy s . 

coordsys (dim, minx, maxx,miny,maxy f ^ mi nz ^ max?] ) 
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The routine reauires the user to specify if the 
coordinate system is to be two or three-dimensional and the 
range of each coordinate. If the oarameter 'dim 1 is two* 
indicating a two-dimensional coordinate system is desired, 
the range of the z coordinate can be omitted, and will be 
ignored if it should be included. 

If this routine is not called by the user the default 
coordinate system will be used. This default system is 
defined as three-dimensional with the x , y, z coordinates 
ranging from -100.0 to 100.0. All coordinate values will be 
interpreted by this default system when coordsys is not 
called by the user . 

As will oe discussed later in this manual, both absolute 
and relative vectors may be utilized in constructing display 
elements. Should an absolute coordinate be specified which 
falls outside the defined coordinate system, a value of the 
nearest coordinate within the defined system will be 
assumed. Should a relative increment be specified which 
exceeds one-half the coordinate range (ie: 100 for default 
coordinate system) a value of zero will be assumed. 

2 . Picture Scale 



The rectangular, 13 by 14 inch, portion of the 



display 


screen 


that 


can be 


viewed by 


the 


user 


is called 


the 


visible 


space . 
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max i mum 
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visible 


space, 


covering 


an area of 
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inches. 
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o f 
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without any distortion. It also permits limited rooming 



The pictorial data being displayed can be adjusted in 
size, or scaled, bv two different controls. One, the gain 
control dials on the Vector General display unit allow the 
user to manually manioulate the picture scale. The second 
provides scale control within the user's program by calling 
the routine pscale. This routine is discussed in detail in 
Section V of this manual. 



IV. CREATING A PICTURE 



A # PICTURE STRUCTURE 

All of the information that a user desires to display on 
the Vector General must be i ncorporatea into the 
hierarchical picture structure defined by the interface 
software* The three hierarchical levels are defined as! 
picture/ object/ element. These levels specify the 
underlying structure of the graphical display and determine 
the operations a user can oerform on information associated 
with each level. 

The term picture refers to all of the data that is to be 
displayed on the Vector General display space. The term 
element refers to the smallest picture segment which can be 
independently referenced and changed without affecting the 
remainder of the picture. Each element/ or independent 
picture segment/ has a unioue name associated with it. A 
collection/ or meaningful grouping/ of elements is called an 
object. Each object is also labeled by a unioue name so it 
can be easily referenced by a user. Figure A - 2 illustrates 
the relationship of the three levels in the actual structure 
of a picture. 

An element is completely described and named by the 
user. It can describe either graphical or ASCII character 
data. An element can be independently added or erased from 
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Hierarchical Picture Structure 
FIGURE A-2 
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the display screen. It can be caused to blink or be 
soecified as being liahtpen selectable* 

Each element must be associated with at least one object 
before it can be displayed on the Vector General. An object 
may consist of from one to ten elements. A user is 
responsible for establishing the desired object-element 
association^ and for specifying a unigue name for each 
object. Each user cefined object can be independently 
rotated/ or translated to any section of the 30 by 30 inch 
disday soace. An object can be added or erased from a 
picture/ scaled/ and specified to blink or to be lightpen 
selectable. Each object’s intensity can be varied in order 
to give three-dimensional objects their depth gueuing. These 
actions/ when applied to a specific object/ affect every 
element that has been associated with it by the user. 

A picture may contain from one to ten objects. The 
coordinate scale and picture scale defined by the user 
affects the entire oicture. A oicture’s coordinate scale 
can be varied but this action will affect every object 
defined as oart of the oicture. An entire oicture can also 
be erased/ specified to blink or be lightoen selectable. 

A summary of the operations for each level of the 
hierarchy is outlined in Figure A - 3 . 



70 



PICTURE: 



Define oicture coordinate system 

Picture scale 

Picture offset 

Erase 

D i sd 1 ay 

Remove 

Ref resh 

B 1 ink 

Lightoen selectable 



OBJECT: 



Translate 

Rotate 

Scale 

Intensity scale 

Intensi ty of f set 

E r ase 

D i s d 1 a y 

Remove 

Blink 

Lightoen selectable 



ELEMENT : 

Erase 
D i so 1 a y 
Remove 
Blink 

Lightoen selectable 



Summary of Ooerat i ons Associated with Each Hierarchial Level 

FIGURE A-3 



B. CONSTRUCTING AN ELEMENT 

Every element is cowol etel y described by the user within 
an element block. There are two tyoes of element blocks. A 
draw element block describes graDhical information. A 
character element describes ASCII characters that are to be 
disolayed. Each element is uniauely named and this name 
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will be used to reference this particular structure. 

1. Draw Element Block 

A draw element block represents a group of draw 
instructions that describe a soecific structure# or picture 
segment. These draw instructions include set vector^ move# 
line# arc and circle. A draw element block beqins with a 
call to the routine drawele and is terminated by a call to 
the routine endele. The draw instructions that are executed 
between drawele and endele describe the actual oicture 
segment . 

The only oarameter required by drawele is a auoted 
character string# or oointer to a character string# 
specifying the name the user wants to associate with this 
element. This name will be used throughout the program to 
reference this element block. 

The basic draw element block# and the related draw 
instructions are represented in the following format: 

- - drawele(*element-name M ); 

! set vector(vtyce# vfnode# (incl# [scale])# 

i 

i . 

i 

i . 

• 

i . 

! setvector (vtyoe/ vmoae» tine ] , tscale] ); 

! ! move(x,[yl,[zl); 

! ! line(x/ty]/[zl); 

! ! circle(dir/centx/ (centyl , (cent?] ); 

! --- a rc (d i r , cent x , teen t y ) > (c en t z) / endx , (enay 1 , lendz 1 ) ; 

I 

I . 

I 

I . 

I 

I . 

enceleO/’ 

The user can select one or more of twelve vector tyoes 
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in constructing an element* These vector types describe how 
the coordinate data will be interpreted in drawing a vector 
on the disolay screen. The choice of a vector effects. the 
parameters that will be passed in each of the move# line# 
circle or arc instructions. The user specifies a vector 
selection by calling the routine setvector. 

a . Setvector 

This draw instruction must be called 
immediately after drawele# and mav be called any number of 
times within the element block. Each setvector# and the draw 
instructions that follow it# comprise a subgrouo. The 
setvector instruction determines the manner in which tne 
line# move# arc and circle instructions in the subgroup will 
be interpreted# as well as their visual appearance on the 
display screen. The routine is called with the followina 
parameters: 



setvector (vtyoe#vmode (#incl l # sc a 1 el ) # 

The parameter vtyce specifies which one of the twelve 
vector types the user wants the following group of line# 
move# arc and circle instructions to utilize. The Parameter 
vmode indicates the vector mode# or appearance of the 
vectors to be drawn (ie# solid line# dotted line# etc.). 
Certain vector types reouire additional information; this 
information is specified by the parameters inc and scale. 

A brief summary of the twelve vector types is listed in 
Taole A - 1 . 
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TABLE A - 1 



NAME 

VA - 
VAX - 

vay - 

V AZ - 
VR - 

V RX - 
VR Y - 

V R Z - 



SUMARY OF VECTOR TYPES 



DESCRIPTION 

vector absolute? each coordinate is soecified 
with resoect to the origin. Each point(x,y>z) 
references a uniaue ooint on the display screen. 

vector absolute aut o- i nc recent x; every draw 
instruction causes the y and z absolute 
values to be updated while x is stepped by a 
constant value. 

vector absolute aut o~ i nc rement y ; every draw 
instruction causes the x and z absolute 
values to be updated while y is stepped by a 
constant value. 

vector absolute auto*i nc recent z'r every draw 
instruction causes the x and y absolute 
values to be updated while z is stepped by a 
constant value. 

vector relative; each x , y , z coordinate 
value indicates the amount that is to be 
added or subtracted from the previous absolute 
coordi nat e ooint. 

vector relative au t o “ i nc remen t x; each draw 
instruction causes the y and z coordinate values 
to be incremented by the soecified value while 
x is stepped by a constant value. 

vector relative au t o ~ i nc remen t yi each draw 
instruction causes tne x and z coordinate values 
to be incremented bv the soecified value while 
y is stepped by a constant value. 

vector relative auto* increment z ; each draw 
instruction causes the x and y coordinate values 
to be incremented by the soecified value while 
z is stepped by a constant value. 



7a 



INC2- 



I NC X 



INCY 



INC3- 



TA0LE a-i 
( cont i nued ) 



two-dimensional incremental vector; a 
relative vector that optimizes storage re- 
quirements. The coordinate increment values 
are limited to values aoorox i lately 3% of the 
user's coordinate ranqe. 

two-dimensional incremental auto-increment x ; 
is a relative vector that ootimizes storage 
r eau i r emen t s . The y coordinate value is 
incremented by a small value while 
x is stepped by a constant value. 

two-dimensional incremental aut o- i nc r ement y? 
is a relative vector that ootimizes storage 
requ i remen t s . The x coordinate value is 
incremented by a small value while 
y is stepped by a constant value. 

three-dimensional incremental vector; a 
relative vector that ootimizes storage re- 
quirements. The x r y> z coordinate increment values 
are limited to values that are apo rox i ma t e 1 y 3% 
of the user's coordinate range. 
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A more detailed account of each vector tyoe and the 



parameters required by setvector are listed in Aooendix B. 
Figure A-4 illustrates the five different vector modes that 
are avail ao 1 e . 

VECTOR MODE 

line 
dashed 
dotted line 
end oo i n t 
dash -do t -da s h 
dash -do t -da s h 

Vector Modes 
FIGURE A-4 

b . Move 

The draw instruction move is used to reposition 
the beam on the display screen. It will produce no visible 
line or pattern. The format of the instruction is: 

moveCx l/yl [>z))7 



The coordinate values 


x 9 y > z will 


be either absolute 


o r 


relative 


values. 


The vector 


tyoe selected in 


the 


preceeo i ng 


setvector 


i nst ruct i on 


will determine how 


the 



value of these parameters will be interpreted. 



PARAMETER VALUE 



VISUAL APPEARANCE 



LN 


/ 


00 


DSH 


/ 


020 


DOT 


/ 


040 


PNT 


/ 


060 


DD 


/ 


0 120 


DDD 


/ 


0140 
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A move instruction under an absolute vector type will 
reposition the beam at the absolute coordinate given in the 
move instruction parameter list. Absolute parameter values 
which exceed the limits of the defined coordinate system 
will be assigned a value of the nearest coordinate within 
the defined system. 

A move instruction under a relative vector type will 
reposition the beam at a location determined by adding the 
parameter values to the oresent beam location. Relative 
parameter values which exceed o n e - h a 1 f the coordinate range 
will be set to zero. 

The bracketed values indicate oarameters that may be 
optional. If the user coordinate system is not three- 
dimensional/ the z parameter can be omitted/ and will be 
ignored if it should be included. 

c . Line 

The line instruction draws a visible line or 
vector on the display screen. The line is drawn from the 
oresent oeam locaton to the soecified end coint. The format 
of the instruction is: 



1 i n e ( x t/yl [ / z 1 ) / 

The coordinate values x, y, z will be either absolute or 
relative values. The vector type selected in the previous 
setvector determines how the value of these parameters will 
be interpreted. 

A line instruction under an absolute vector tvDe will 
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draw a line from the cresent beam position to the absolute 
coordinate specified in the line instruction parameter list. 
Absolute oarameter values which exceed the limits of the 
defined coordinate system will be assigned a value of the 
nearest coordinate within the defined system. 

A line instruction under a relative vector type will 
draw a line from the present beam oosition to a ooint 
determined by addina the parameter values to the present 
beam location. Relative parameter values which exceed one- 
half the coordinate range will be set to zero. 

If the user has defined a two-dimensional coordinate 
system, the z parameter can be omitted, and will be iqnored 
if it should be included. 



d . Circle 

The circle instruction will draw a circle 



beginning at the present 
point specified by the user, 
present beam location and 
radius of the circle. The 
following format: 

ci rcleCdi r,centx 



beam location about the center 
The difference between the 
the center point determines the 
instruction is used by the 

C,centy] [,centz] ); 



The parameter dir indicates in which direction the 
circle is to be drawn, clockwise or counterclockwise. The 
number of parameters reauired and their values are 
determined by the vector type selected in the previous 
setvector instruction. 
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Circle commands issued under absolute vector types will 
cause the circle to be drawn about a center point as 
specified in the parameter list. Absolute parameters which 
exceed the limits of the defined coordinate system will 
assume a value of the nearest coordinate within the defined 
system. 

Circle commands issued under relative vector tyoes will 
cause the circle to be drawn about a center point determined 
by adding the parameter values to the present beam location. 
Relative oarameter values which exceed one-half the 
coordinate range will be set to zero. 

If the user coordinate system is two-dimensional, the z 
parameter can oe omitted, and will be ignored if included. A 
circle cannot be drawn by any of the four incremental 
vectors. 



e . Arc 

The arc instruction will draw an arc from the 
present beam location, about the specified center point, to 
the desired end point. The distance between the start i na 
point and the center point determines the radius of the arc 
being drawn. The instruction format is : 

arc(dir,centx ( , c e n t y ] I/centz) ,endx [,endy] [,endz] ) ? 

The parameter dir, gives the direction the arc is to P e 
dra«n, clockwise or counterclockwise. The arc's actual 
center and end points are determined by the vector tyoe 
selected in the previous call to setvector, and by the 
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supolied parameter values. 

Arc commands issued under absolute vector tyoes will 
result in the center and end points beinq absolute 
coordinates as given in the command parameter list. 
Absolute oarameters which exceed the limits of the defined 
coordinate system will assume a value of the nearest 
coordinate within the defined system. 

Arc commands issued under relative vector tyoes will 
result in the end point of the arc being determined by 
adding the e n d x , endy f and endz values to the present beam 
location. The center point is then obtained by adding the 
cent x , c e n t y , and centz values to the end ooint. Relative 
oarameters which exceed one-half the coordinate range will 
oe set to zero. 

If the user coordinate system has been defined as two- 
dimensional / the z oarameters can be omitted, and will be 
ignored if included. An arc cannot be drawn by any of the 
four incremental vectors. 

If the distance from the starting ooint of the arc to 
the center point, and the distance from the end point to the 
center ooint are not equal, the resulting arc will contain a 
straight line. The straiqht line results from the arc 
generator trying to compensate for the two different 
distances to the center point. One distance will be used to 
determine the radius of the arc r the arc will then be drawn 
using this radius. The arc will stop at the systems new 
defined end point and a straight line will be drawn to the 
end point that had been specified by the user. The resulting 
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arc appears in the following form 



2. Character Element 

A character element represents ASCII character data that 
is to be incoroorated into the oicture structure. A user can 
soecify a character element containing ASCII/ soecial Vector 
General characters ana formatting symbols to be disolayed on 
the Vector General disolay screen. A user can select from 
four character sizes and has the option of selecting a 
slanted character set. The text can be displayed 
horizontally or vertically on the screen. The vertical 
position causes the characters to aopear as if they were on 
a page that had been rotated ninety degrees counter 
clockwise. The user can select the position on the screen 
where the strinq is to beqin, or can output it relative to 
the present beam position. 

Each character element is given a uni aue name by the 
user. This name will allow the user to easily reference 
each character element. There are two routines which can 
produce character element strings. 

a . Charele 

The charele instruction produces a character 
element string of a given lenqth. The charele character 
element generally reauires less display list space than the 
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orintv character element and is designed for elements which 
do not change. The character element is represented by the 
following format: 

chareleC"e1ement-name H #string#size#wdir#slant#x#y); 

The oarameter string can be either a quoted strina 
within the oarameter list or a pointer to a character string 
or array. The character strinq will begin at the o o i n t ( x # y ) 
or can be output relative to the present beam location by 
replacing the x and y parameter with the constant VGREL. 
For example# the following character element# when linked to 
an object# would be output relative to the present beam 
oosi t i on : 

chareleC 1 element-name” #” Now is the time" #SZ* : i#HOR#SLMT#VGREL) 

A summary of the character element parameters is 
presented in Table A-II. The character set available on the 
Vector General is illustrated in Figure A - 5 . All of the 
Vector General characters can be represented within a 
character string. The special formatting symbols and 
special Vector General characters are listed in Appendix B. 
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TABLE A - 1 I 



SUMMARY UF CHARACTER ELEMENT PARAMETERS 



size: specify character size 

SZ / 00 - use previously defined character size 



SZ1 


/ 


0100 


- set 


size 


t 0 


100 


col umns 


by 


60 


lines 


SZ2 


/ 


0120 


- set 


size 


t 0 


01 


CO 1 umns 


by 


41 


lines 


SZ3 


/ 


0 1 U0 


- set 


size 


t 0 


60 


col umns 


by 


30 


lines 


SZ4 


/ 


0 ioO 


- set 


size 


to 


32 


co 1 umns 


by 


16 


lines 



wdir: write direction 

HOR / 00 - write characters horizontally 

VER / 0200 - write characters vertically 

slant: specifies regular or slanted characters 

SLNT / 00 - slanted characters 

NSLNT / 01 - regular characters 
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Character Set 
FIGURE A-5 
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b . Printv 



The or intv instruction provides for a formatted 
output character element string of variable length. Maximum 
character length for a orintv character element string is 
100 characters. The orintv character element is designed 
for output character strings which change frequently. The 
orintv character element is represented by the following 
forrat : 

d r i n t v ( " elename"/Si z e / w d i r / si ant / xpoSf ypos/ ” format” 

( / a ra 1 , a rg2 / . . . . . / a ra 1 0 1 ); 

The first six parameters are iaentical in use to the 
charel e format in initializing and oositioning the character 
string. The orintv character string cannot/ however/ be 
positioned relatively but must be supplied with both X and Y 
absolute coordinates. The format parameter and ten optional 
arg parameters are used as in a standard printf statement in 
format t i ng out out . 

An example of the use of the orintv character element 
*ou Id oe as follows: 

orintv( H RESULT n /SZa/H0R/SLNT/5.0/0.0/ N resul t = %d'\ 

result); 

and could be changed later in the program to: 

Drintv("RESULT" / SZ3/HC3R/NSLNT/-10.0/15.0/"score = 7. d"/ 

score) ; 
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C. LINKING ELEMENTS to objects 



Draw and character elements represent the smallest 
picture segment that can be independently referenced by the 
user. In order to display an element it must be associated 
with at least one object. An object represents the smallest 
entity that can be displayed independently on the Vector 
General screen. 

1. Object Routine 

Each object is given a unique name so it can be 
easily referenced by the user. Elements can be linked to an 
object at one time or by several different calls to the 
routine called object. An object can consist of one or more 
elements. A specific element can be linked to several 
aifferent objects# or may be linked to one object several 
times. This ob j ec t -e 1 emen t association or linking is 
established by the routine object* This routine has the 
following f o rma t : 

object (num# "obj ect-name" # "el ement-name" # . * . # "element-name") # 

The parameter num indicates the number of elements that 
are to be linked to the named object by this call. The 
elements are referenced by the names specified by the user 
in the orecedi nq drawele# charele# and printv routines. 
Since each object is associated with a uni aue name# a second 
call to object# with a duplicated object name# will cause 
t he elements to be added to the object first associated with 
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that name 



when an element is linked to a specific object several 
times# the user can no lonqer reference a specific 
occurrence of this element within the object# for example: 



object (3# "Tree 1 / "branch", "branch", "branch") ? 



In this case the element branch has been linked to the 
object tree three times. When displayed# element branch 
will apoear three times. Now# however# the user cannot 
uniauely reference a specific occurrence of the element 
branch. If the element called branch was selected to be 
erased# the first occurrence of branch would be erased from 
the screen. In many instances it may be desirable to 
uniquely reference each occurrence of an element within a 
specific ooject. This can be accomplished by associating 
several uniaue names with an element. The routine copyele 
provides this capability. 



2 . Copve 1 e Soutine 

This routine allows a user to assign several unique 
names to a specific element structure. In this way# an 
element structure can be associated with an object several 
times and each occurrence can be uniquely referenced. Tne 
routine is represented by the following format: 



copy e 1 e (num / "el ament-name" # "copy 1 -name" # "copy2*name" # . • . ) # 
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The parameter num indicates the number of additional names a 



user wishes to associate with the named element structure. 
The "e 1 emen t -name" refers to a previously defined draw 
element or character element block. Each of the "copy- 
names” must be unique. 

Now reconsider the previous example. If the element 
branch is assoc i atec with two other unique names and these 
three names are used in the object-element linking, each 
occurrence of the structure can now be uniquely referenced 
oy the user. The following two statements will accomplish 
this task. 

cooyel e ( 2 , "branch", "branch 1 ", "branch^") ; 
object (3, "tree", "branch"," branch 1 " , "branch2 M ) ? 
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V. USER SUPPORT ROUTINES 



After the user has incorporated all data that is to be 
disolayed into the desired picture structure* it can now be 
manipulated and transformed* The following user routines 
provide the means to manipulate the picture* objects and 
elements that have been created by the user. 

A description of each user routine* calling format and 
error diagnostics are included in Aooendix B. 

A . PICTURE REPRESENTATION 

1 . Blink 

The display blin* mode can be set for the entire 
picture* sinqle object or for any number of elements 
associated with a specific object. Modifying the blink mode 
of an object affects all the elements associated with that 
object. The routine blink will turn the blink mode on or 
off for the specified picture segment. 

2 . Erase 

The entire picture* a single object or any number of 
elements associated with a specific object can be erased 
from the display screen. The picture segments that are 
erased from the screen can be redisplayed by again 
establishing the desired object-element association. This is 
accomplished bv calling the routine object* as described 
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earlier. Erasing an object will affect all elements 
associated with the named object. 

3, Remove 

The routine remove provides a user with the ability 
to release the memory locations associated with a specific 
element structure. The user can remove the picture and 
release all the memory locations that have been used to 
describe all the existing elements. Additionally the picture 
will be erased from the screen. Each element that is removed 
from memory can no longer be referenced or linked to 
objects. An individual element can also be removed from 
memory. This will cause every occurrence of the element to 
be erased from the screen and the memory locations 
associated with the element’s description will be released. 
The user can specify an element for removal by either its 
original name or by any of the copy names associated with 
it. Remove results in the elimination of all occurrences and 
all copies of an element from the display screen. An 
element that has oeen removed can be redisplayed only by 
reconstructing the element block and by again establishinq 
the desired object-element association. 

4 . Display 

The display of the entire picture* an object* or 
individual elements may be activated or deactivated with 
this routine. Object-element associations are not affected 
with this routine as they are with erase and remove. 
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5 . Refresh 



The default disolay refresh rate is 40 Hz and may be 
altered from 15 to 120 Hz with this routine. High refresh 
rates ensure no flicker but may not allow enough time to 
execute all desired draw commands before refresh begins 
aqain. Low refresh rates allow more draw commands but with 
an increase in flicker. 

6. Offset 

Picture coorainate axis oosi tionina is normally 
centered on the display screen but may be altered with this 
routine. Alter i n a of the picture coordinate axis will 
affect all objects in the picture. 



7 . Psc a 1 e 



Modi f 


i c a t i 


on of 


the 


picture scale may 


be 


accomo 1 i shed 


by 


cal 1 i ng 


this 


routine. All objects wi 


thin 


the disolay 


are 


affected 


by 


a modification with 


this 



routine. 

8. Intensity Offset 

The routine intoffset allows the user to vary the 
intensity level of a three-dimensional object, or impose a 
screen cut-off plane for the named object. 

9. Intensity Scale 

The routine intscale allows a user to vary the 
intensity of a three-dimensional object. This provides the 
deoth-cueing or shading for a three-dimensional object. 
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B. PICTURE MANIPULATION 



1 . Rotate 

This routine allows a user to rotate an object about 
the x 9 y f and z axis. The rotation of an object affects all 
elements associated with the named object. Arcs* circles 
and characters are always drawn in a plane parallel to the 
screen# and are rotatable in a three-dimensional coordinate 
system about the z-axi s. 

2 . Scale 

The routine scale allows a user to independently 
scale any object of the oicture. All elements associated 
with the object will be scaled by the specified scale 
f ac t or . 

3. Translate 

The routine trans allows the user to move an object 
anywhere in the display space. Tne object and all its 
associated elements can be moved in the x # y# and z olanes. 
Continually translating an object by very small increments 
will cause it to appear as if it is moving across the 
display screen. 

4 . P 1 ac e 

The place routine allows the user to place or 
position an object anywhere in the display space. 
Specification of an absolute coordinate value will cause the 
coordinate axes of the object to be centered on the 
specified value. 
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C. EXTERNAL DEVICES 



1 . Cursor 

This routine allows the user the option of 

activating or deactivating the display of the trackball# 
joystick# or lightpen cursor. 

2 . Posit 

This routine will return to the user a floating 
point value of the Dosition of the trackball# joystick, or 
lightoen cursor. The cursor need not be displayed for this 
routine to work. 

3. Keyboard 

a . Cget 

The routine cget allows a user to receive and 
output characters from the Vector General keyboard onto the 
display screen. The ASCII character data is also placed in 
a user specified character array for processing by the 
user's program. Up to 121 characters can be entered. Data 
entry is terminated by a carriage return. The termination 
of the data entry also erases the output characters from the 
display screen. 

b . Fae t 

The fget routine returns to the user a floating 
point number entered from the Vector General keyboard. This 
routine uses both the cget and getf routines. 
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c. Iget 

The iget routine returns to the user an integer 
entered from the Vector General keyboard. This routine uses 
both the cget and geti routines. 

4. LightDen 

a. Lghtpen 

The lightDen s e 1 ec t ab i 1 i t y of the picture/ a 
single object/ or any number of elements associated with a 
soecific object can be turned on or off by this routine. 
This determines what picture segments will be affected by 
lightPen interactions. 

b . P e n h i t 

After an element's lightoen s e 1 ec t ab i 1 i t y has 
been activated with the lghtoen routine/ determination of 
whether or not an element has registered a liahtpen hit is 
accomplished with this routine. A one is returned if a 
lightPen hit has occurred? otherwise a zero is returned. 

For an element to register a lightpen hit it is 
necessary not only for the element's lightoen s e 1 ec t ab i 1 i t y 
to have oeen activated/ but also the lightpen must be 
pointing at the element and the lightoen sense switch must 
oe activated. The lightoen sense switch is activated bv 
bridging the small rubber gao on the forward part of the 
1 i g h t p e n . 
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c 



Cl r h i t 



This routine is used to clear the elements of 
lightoen hits# Element lightoen s e 1 ec t ab i 1 i t y is unaffected 
by this routine# 

5. Function Switches 



a • Fsman 

This routine returns to the user an indication 
of whether or not a specified function switch is depressed# 
A one is returned to the user if deoressed* otherwise a zero 
if returned. 

b . Fs t og 

This routine makes the function switches appear 
as toggle switches. Odd ( 1 s t r 3rd r . • • ) selections of a 
switch light the lamp ana return a value of one# Even 
( 2nd t 4 t h , . . . ) selections turn the lamp off and return a 
value of zero. 



c . Lamp 

The lamo routine will light or extinguish the 
specified function switch lamp. 



d . Man i n t 

Each deoression of the manual interrupt function 
switch increments the manual interrupt count by one. The 
manint routine either returns to the user the present manual 
interrupt count or sets that count to zero. 
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Control Dials 



The dial routine returns a floating point number 
-1.0 to 1.0 to the user to indicate the relative posit 
the specified control dial. 
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VI. RUNNING A VECTOR GENERAL PROGRAM 



A. PROGRAM FORMAT AND COMPILATION 

In order to properly utilize the Vector General display 
system# routines to initialize and terminate the system must 
be called. These routines initialize the Vector General# 
start tne actual visual display and prooer I y terminate the 
display at the end of a user's program. Each user program 
must include a call to these three routines: 





sy s i n i t ( ) / 
vgo i c t u re ( ) / 
vgt erm ( ) ; 


The 


first routine/ sysinit/ must be called by the user 


before 


any other user interface routine is called. To 


d i so 1 ay 


the picture that a user has described on the Vector 


General 


screen/ the routine vgpicture must be called. This 


rout i n e 


is called only once/ and notnina will appear on the 


screen 


until it has been called. Finally/ to properly 



terminate/ the system requires a call to the routine vqterm 
at the end of the user program. 

1 • C Programs 

To properly initialize various data structures in 
the interface routines and utilize the Vector General 
program constants usee in this manual the first line in the 
user's program should be: 
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^include "/usr/graoh/vgdata 



Once a C orogram has been written it must be comoiled 
with the user interface graphics subroutine library. To 
accomplish this the following command must be issued: 



The result of a successful compilation is an executable 
a . ou t file. 

2. Basic Proarams 

The first subroutine call made by the BASIC program 
shou Id be : 



This causes the loading of the initialized display list. 
Care must be made in previously declaring the "vadata" call 
in an "extern" statement before this call. This call would 
be in lieu of the "include" statement used by the C 
programs. 

The program constant names used in the C Vector General 
programs do not apply in BASIC Vector General programs. 
Conversion values must be utilized instead of the string 
constant names when programming in 8ASIC. The following 
table lists the constant names and the eauivalent values in 
decimal number r ep r esen t a f i on to be used: 



vgc f i 1 ename . c 



call vadat a ( ) 



DEFINE VECTOR TYPES 



VR = a096 
VRX = 9097 
VR Y = 9098 



VAY = a 1 02 
VAZ = 9103 
INC2 = 9109 
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VRZ 




a099 




INCX = a 1 05 


V A 


3 


aioo 




INCY = ai06 


VAX 


= 


a l o l 




I NC 3 = a l 07 








define 


VECTOR MODES 


LN 




0 




PT = as 


OSH 


- 


16 




DD = 80 


DOT 


— 


32 




ODD = 96 








DEFINE 


COORDINATE FIELD VALUES 


AIR 


• 


0 




X = 0 


XR 


r 


1 




Y = 1 


YR 




2 




Z = 2 


ZR 


- 


3 


DEFINE 


OF AND CF FIELDS FOR ARC COMMANDS 


C = 


: a 






CC = 


: 8 












DEFINE 


FIELDS FOR INCREMENTAL VECTORS 








INCREMENT SCALE 


NMG 


3 


0.0 






MG 


Z 


128.0 


DEFINE 


CONSTANTS FOR CHARACTER GENERATION 


SLNT 


- 


0 




VGREL = -.00001 


NSLNT 


= 1 












CHARACTER WRITE DIRECTION 


HOR 


3 


0 






VER 


- 


128 












CHARACTER SIZE 


sz 


3 


0 




SZ 3 = 96 


SZ1 


- 


6a 




SZa = 112 


SZ2 




80 


DEFINE 


ACTION PARAMETER 


ON 


3 


1 




CLEAR - 0 


OFF 


- 


0 




COUNT = 1 








DEFINE 


CASE STATEMENT VALUES FOR 08J-ELE- 


PIC 


3 


0 




ELE = 1 


OBJ 


Z 


-1 


DEFINE 


DEVICE SWITCH NUMBERS 


IPEN 


3 


0 




JOY = 2 


TRK 


Z 


1 







Once a BASIC Drocram has been written, it must be 
comoiled with the various user subroutine libraries. To 
accomplish the task, the followinq system resident command 
must be i ssued : 



vgb f i 1 ename.b 

The result of a successful compilation is an executable 
"a. out" file. 
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B. SAMPLE programs 



1 . CP roqrams 

The following is an example of a C-)anguage Vector 
Genera. graphics program. The actual Picture produced by 
this program is illustrated in Figure A-6. 



^include " /u s r /g r aph / vgda t a " 

m a i n ( ) 

{ 

i n t i ; 

sysinit(O); //initialize the Vector General 
//define coordinate system 

coordsys(2,-1.0,l. 0,-1. 0 , 1 . 0 ); 

drawele("box")» 

setvector(VA,LN) ; 

mo ve ( - 1 . 0 , - 1 . 0 ) ; 

1 i n e ( 1.0, — 1.0); 

1 i n e ( 1.0, 1.0); 

I i n e ( - 1 . 0 , 1.0); 

I ine(-l .0,-1 .0); 
ende 1 e ( ) ; 

charele("name",“*I 80X",SZ«,H0R,NSLNT,VGREL); 

drawele("zigzag") • 

setvector(VA,LN); 

move ( -0 . 5 , -0 . 5 ) ; 
set vector (INCX,LN, .03,NMG) ; 
f o r ( i = 0 ,' i< 7 ; i++ ) 

1 ine(.03,-.03); 
enoe 1 e ( ) ,' 

//establish object-element relationship 
object (3, "bigbox"," box"," name ","zigzaq"); 
object (3, "smal Ibox", "box", "name", "zigzag") ; 

scale("biqdox",0.5); 
trans("biabox",-0.5,-0.5); 
seal e ( "smal lbox",0.25); 
trans("smal lbox",0.5,0.5); 

vqpictureO; //display picture 
s)eep(30); //oisolay picture for 30 sec 
vqtermO; //terminate Vector General process 

) 
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2 . Basic Program 

The following is an example of a BASIC Vector General 
graphics program. The actual picture produced by this 
program is illustrated in Figure A - 6 . 



rem external subroutine declarations 
extern vgdataO 
extern svs i n i t ( i nt ege r ) 

extern coordsys(integer, double, double, double, double) 
extern dr awe 1 e ( &c h a r ) 

extern setvector( integer, integer, double, double) 
extern move ( doub 1 e , doub 1 e ) 
extern 1 i ne ( doub 1 e , doub 1 e ) 
extern endeleO 

extern charel e(4char, Jchar, integer, integer, integer, doubl e) 

extern object (inteaer,&char,&char,&char,&char) 

extern sc a 1 e ( &c rt a r , doub 1 e ) 

extern trans(&char,double,double) 

extern vgpictureO 

extern s 1 eeP ( i n t ege r ) 

extern vgt e rm ( ) 

rem initialize display list 

call vgda t a ( ) 

rem initialize the Vector General 

call sysinit(O) 

rem define coordinate system 

cal 1 coordsys(2, -1 .0, 1 .0,-1 .0, 1 .0) 

call' drawele("box H ) 

call se t vec t o r ( 4 1 0 0 , 0 , 0 , 0 ) 
call move ( - 1 . 0 , - 1 . 0 ) 
call line (1.0, -1.0) 
call line (1.0, 1.0) 
call 1 i ne ( - 1 .0, 1 .0) 
call line(-1.0,-1.0) 
call ende 1 e ( ) 

call charele("name","»I BOX" , 1 1 2, 0 , 1 , - . 0000 1 ) 

call oraweleC’zigzag") 

call se t v ec t o r ( A l 0 0 , 0 , 0 , 0 ) 
call mov e ( ”0 . 2 , 0 . 0 ) 
call s e t vec t o r ( A 1 05 , 0 , . 0 3 , 0 ) 
for i = 0 to 6 

call line (.03, -.03) 
next i 

call ende 1 e ( ) 

rem establish ob j ec t -e 1 emen t relationship 

call object ( 3 , " b i gbo x " , " box " , " name " , " z i gzag " ) 
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call ob j ect (3, "smal 1 box", "bo x " , " name", "zigzag") 

call sc a 1 e ( " b i qbo x " , 0 . 5 ) 
call t p ans ( " b i qbo x " , - 0 . 5 , -0 . S ) 
call scale("smallbox",0.25) 
call trans("sma1'lbox"»0.5#0.5) 

rem disolay oicture 

call vgpictureO 

rem disolay oicture for 30 sec 

call s!eeD(30) 

rem terminate Vector General process 

call vqt e rm ( ) 
end 
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/vwwv\ 



BO X 




y 



Picture Disolayed by Sample Proqram 
FIGURE A-6 
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C. ERROR DIAGNOSTICS 



A user can control the printing of error messages 
through the use of the errormsg routine* The general format 
of an error message will be as follows: 

E-nn TTTT: H eeee rt in routine rrrr ( ) 
where: 



nn - 


error number 


TTTT 


- error t y oe 


eeee 


- error 


rrrr 


= routine in 



error 



For example: 



1. E-t BLOCK: in routine line() 



Message indicates a block error in routine 



1ine(). Probable cause is 
outside a dr'aweleO block, 
be disregarded and control 
program, 



a lineC) command issued 
The 1ine() command will 
returned to the user's 



2* E • 5 NO OBJ: "Tree” in routine eraseC) 



Message indicates that the object 'Tree' has 
been used in the erased routine and no sucn object 
currently exists* Routine will be disregarded and 
control returned to the user's program. 

3* E - 1 5 X: M 150. 000000" in routine printvt ) 



Message indicates an improper X coordinate 
value in the o r i n t v ( ) routine* The erroneous X 
coordinate value of 150 will be reduced to a value 
within the defined coordinate system Cie: 100 for 

default coordinate system) and the routine will 
continue execution. 

4 . E-25 NUM DIAL: ”36" in routine dial ( ) 

Message indicates an improper dial number 
of 36 used in the dial() routine* Routine will 
return a value of 0.0 to the user* 

A brief idea of the cause of the error may be gained 



from t n e error t yoe specification in the error message, 
hooefully with a soecification of the error/ the error type 
and routine where the error occured/ the user will be able 
to Quickly trace and correct the problem. Should a more 
detailed exolanation be desired/ a fuller description of the 
specified error may be obtained with the help of the error 
number and error diagnostic table/ or by reviewing the 
diagnostic section under the routine in question. 

The software support package is designed so that most 
errors will not terminate a user's program/ and in fact most 
errors will usually result in the termination of the 
specified routine and return control to the user's program. 
Every effort will be made to execute the support routines 
and user's program to completion so that at least some of 
the user's data will be displayed. 



T ABLE- 1 1 1 

ERROR DIAGNOSTIC TABLE 

E-l ELEMENT BLOCK ERROR - The. specified routine is in 

error in one of two respects. Either the routine 
has been called outside a draweleC) block when it 
should be within/ or the routine has been called 
within a craweleO block when it should be 
outside. The instruction will be ignored and 
control returned to the user's program. Block 

errors have a tendency to occur in groups when the 
programmer is not careful in constructing element 
blocks. 

E-2 SPACE ERROR - Space allocated by the system for 

the building of elements has been exceeded. See 
the routine remove in order to free up unnecessary 
element memory locations. The instruction 

executing when this error occurs will be ignored 
and control will be returned to the user's 
program. 

£-3 DIRECTION ERROR - The value of the parameter 'air' 
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E-a 



E-5 



E-6 



E-7 



E-3 



E-9 



E-10 



E-l 1 



was not C or CC in the specified routine. A 
direction of C will be assumed and the routine 
will continue execution, 

CHARACTER ERROR - A character symbol included in 
an ASCII character string is undefined. The 
symbol will be ignored and control will be 
returned to the user’s orogram. 

OBJECT ERROR - The named object does not exist; it 
has not been defined in a call to the routine 
objectC). A specification of a non-existent 
object will terminate the routine and return 
control to the user’s program. 

ELEMENT ERROR - The named element does not exist; 
it has not been defined in a call to drawel e( ) / 
chareleO# or printvC). For routines that specify 
a number of element names/ this type of error 
normally results in skipoinq the specified element 
and continuing the routine with the next element. 

DUPLICATE ELEMENT ERROR - An element name has been 
duplicated in a drawel e( ) or chareleC) call. Each 
element structure created by drawel e( ) or 
chareleO must have a unique name. This error 
usually results in either skippinq the designated 
element and continuing the routine/ or termination 
of the routine and return to the user’s program. 

ELEMENT NUMBER ERROR -The total number of elements 
allowed by the svstem has been exceeded. Maximum 
number of elements allowed is 70. The user should 
consider using the removeO routine to delete 
unnecessary elements so new elements may be 
i n t r oduc ed . 

OBJECT NUMBER ERROR - The number of objects allow- 
ed by the system has been exceeded. Maximum 
number of objects is 10. 

VECTOR MODE ERROR - Specified vector vmode in 
setvector ( ) routine is in error. A vector mode of 
LN will be assumed and the routine will continue 
execution. See the setvectorO summary for 
allowable vector mode codes. 

DIMENSION ERROR - The coordinate dimension speci- 
fication is in error. Either the ’dim’ parameter 
in coordsys ( ) is in error# or a vector type of VAZ 
or VRZ has been specified with a two-dimensional 
coordinate system. The routine in question will 
be skipped and control returned to the user’s 
program. 
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E-12 



E-13 



E-ia 



E - 1 5 



E-16 



E-l 7 



E - 1 a 



E-l<? 



E-20 



AOO ELEMENT ERROR -An error has occurred in c g e t ( ) 
or object ( ) in attempting to build a new element. 
Routine terminates and control is returned to the 
user's program . 

MAKE OBJECT ERROR - An error has occurred in 
cge t O or object!) in attempting to build a new 
object. Routine terminates and control is 
returned to the user's program. 

VECTOR TYPE ERROR - An improoer vector type was 
specified in routine setvectorO . ' A vector type 
of V A will be assumed and the routine will 
continue executing. See the setvectorO summary 
for allowable vector type codes. 

X COORDINATE/INCREMENT ERROR - The specified x 
parameter exceeds allowable limits. If an 
absolute x coordinate exceeds the defined 
coordinate s v s t e m , the x value will be set to the 
value of the nearest coordinate within the defined 
system (xmin or xmax). If the parameter specifies 
an x increment which exceeds one-half the 
coordinate ranger the parameter is set to zero. 

Y COORDINATE/INCREMENT ERROR - The specified y 
parameter exceeds allowable limits. If an 
absolute y coordinate exceeds the defined 
coordinate system, the y value will be set to the 
value of the nearest coordinate within the defined 
system (ymin or ymax). If the parameter specifies 
a y increment which exceeds one-half the 
coordinate range, the parameter is set to zero. 

Z COORDINATE/INCREMENT ERROR - The specified z 
Parameter exceeds allowable limits. If an 
absolute z coordinate exceeds the defined 
coordinate system, the z value will be set to the 
value of the nearest coordinate within the defined 
system (zitin or zmax). If the parameter specifies 
a z increment which exceeds one-half the 
coordinate range, the parameter is set to zero. 

ELEMENT NUMBER ERROR - The parameter ’num' spe- 
cifying the number of elements being passed in 
this routine is not -1 to 10. A 'num' value of 10 
will be assumed and the routine will continue 
executing. 

CIR/APC ERROR - A circle or arc cannot be drawn by 
an incremental vector. The routine is skipped and 
control returned to the user’s program. 

USER BUFFER ERROR - The size of the supplied user 
buffer has been exceeded. Either enter a carriage 
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E-2 1 

E-22 

E-23 

E-2« 
E -25 

E-26 

E-2 7 

E-28 

E-29 

E-30 

E-31 



return or erase (cntrl-a) Dart of the buffer. 

ADD OBJECT ERROR - An error has occurred in cget() 
or object () in attemDting to add an object to the 
display. Routine terminates and control returned 
to the user's program. 

OBJECT LINK ERROR - The specified element is not 
linked to the specified object. Error usually 
results in skiooing the element in Question and 
continuing the routine with the next element. 

FUNCTION SWITCH NUMBER ERROR “An improper function 
number was specified. The routine terminates and 
control is returned to the user's program. A 
value of zero is returned to the user. 

ACTION VALUE ERROR - An imciroper action value was 
specified in this routine. Refer to routine 
summary diagnostics for specific action taken. 

0 1 AL NUMBER ERROR - An improper dial number was 
specified in routine dial!). The routine 
terminates and a value of 0.0 is returned to the 
user's o rog ram. 

ELEMENT ERROR -Element specified in printv routine 
was specified earlier as other than a printv 
element. Routine will be skipped and control 
returned to the user's program. 

DEVICE NUM8ER ERROR -An improper device number was 
used in this routine. For sysinit!) a device 
number of zero will be assumed and the routine 
will continue. For cursor!) or oositO the 
routine will terminate and control will return to 
the user's program. The oositO routine will also 
return a value of 0.0 to the user. 

COORDINATE SPECIFICATION ERROR - The specification 
of a coordinate in this routine is in error. The 
routine terminates and a value of 0.0 is returned 
to the user. 

DIMENSION ERROR - Neither the lightpen nor the 
trackball have a z coordinate specification. The 
routine terminates and a value of O'. 0 is returned 
to the user. 

VALUE ERROR - The 'val' parameter in intscal e( ) or 
i ntof f set ( ) » or the ’rate' parameter in refresh!) 
is in error. The routine terminates and control 
returns to the user's program. 

CUT ERROR - The 'cut' parameter in intscale!) is 
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E-32 



E- 33 



E-34 



E-35 



E-36 



E- 37 



not zero or one. The routine terminates and 
control returned to the user's program. 

DUPLICATE LINK ERROR - The specified element is 
al* ready linked to the object. The routine 
continues execution with the next specified 
e 1 emen t . 



BUFFER LI M IT ERROR ~ Either the supplied user buf~ 
fer has been filled or 121 characters have been 
read in the caet ( ) routine. The routine will wait 
for either a carriage return or erasure (cntrl-a) 
of part of the buffer contents. 

FORMAT ERROR - The desired output string exceeds 
100 characters in the printvC) routine. The 
routine will print only the first 100 characters. 



WRITE ERROR - The write direction parameter is in 
error. A default value of HOR will be assumed and 
the routine continued. 



SLANT ERROR - The slant parameter is in error. A 
default value of NSLNT will be assumed and the 
routine continued. 

SIZE ERROR - The size oarameter is in error. A 
default value of SZ9 will be assumed and the 
routine continued. 
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APPENDIX B 



USER SUPPORT ROUTINE DESCRIPTIONS 

The description of the user interface routines appear in 
a format similar to the routine descriptions in the UNIX 
Reference Manual at the Naval Postgraduate School Computer 



Laboratory 



arc 



arc 



NAME : 



arc - draw an arc 



SYNOPSIS: 

2- d i men s i ona 1 coordinate system 

VR/VA : arc(dir,centx,centy,endx,endy) 

VRX/VAX: arc (di r/centy/endy) 

V R Y / V A Y : a r c ( d i r , c en t x / end x ) 

VRZ/V AZ : not allowed 

3- dimensional coordinate system 

VR/VA : arc(dir/centx,centyfcentz,endx,endy,endz) 
VRX/VAX: arc (di r/centy/centZ/endy/endz) 

VRY/VAY : arc(di r/centx/centz/endx/endz) 

VRZ/V AZ : arc(di r,centx#centy/endx^enay) 

int dir: CC / 004 - counter clockwise 
C / 010 - clockwise 

float centx,centy,centz,endx,endy,endz; 



DESCRIPTION: 

An arc is drawn from the present beam location/ about 
a center do int to an end point. The location of the 
center and end ooints deoend upon the specified vector 
type and suoolied center and end point parameters. 
The Parameters oassed for the center and end points of 
the arc are either relative or absolute values. The 
number and value of these parameters are determined by 
the vector type selected in the previous call to set- 
vectorO. If the center point is not an eaual dis- 
tance from the starting ooint of the arc and the end 
point/ an arc will be drawn using one of the distances 
as the radius. The result is a straight line drawn 
from the actual terminating ooint of the arc to t n e 
end point. 

If the vector type is an absolute vector/ the center 
and end points will be as given in the parameter list. 
Auto-increment vector tyoes will cause the center and 
end ooints to have the same coordinate value as the 
starting ooint for the designated auto-increment coor- 
dinate. Under absolute vector types/ parameters which 
fall outside the defined coordinate system will assume 
a value of the nearest coordinate within the defined 
system. 



1 1 1 



arc 



a rc 



If the vector type is a relative vector, the end point 
of the arc will be obtained by adding the endx, endy, 
and endz values to the starting point. The center 
point is then obtained by adding the centx, centy# and 
centz values to the oreviously obtained endooint. As 
with absolute vectors, auto-increment modes cause the 
center and ena ooints to have the same coordinate 
value as the starting point for the designated auto- 
increment coordinate. Under relative vector types, 
parameters which exceed one-half the coordinate range 
will be set to zero. 

Arcs cannot be drawn by any of the four incremental 
vectors. 



01 AGNOSTICS: 

All errors will oe orinted on the PDP-11 terminal 
sc r een . 



ERROR 


CAUSE 


ACTION 


E - 1 


Routine has been called 
outside a draweleO block 


Return 


E-2 


No more space available 
in display list 


Return 


E-3 


The draw direction was not 
de f i ned as C or CC 


d i r = C 


E-t 1 


3D not defined 


Return 


E-15 


The x value was out-of-bounds 


x = x m i n 
or x ma x 
or 0,0 


0 

1 

LU 


The y value was out-of-bounds 


y - y m i n 

or y ma x 

or 0.0 


E-l 7 


The z value was out-of-bounds 


z = zm i n 
or zma x 
or 0.0 


E-19 


Illegal arc instruction 
from incremental vector 


Return 



ALSO SEE: 

circle# setvector 
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D 1 i n k 



b 1 ink 



NAME : 



blink 



blink the entire oi cture or the specified 
object or elements 



SYNOPSIS: 

b 1 i nk (ac t i on, num, "ob jname" , "e 1 e 1 " , "e 1 e2" , . . . , "el e 1 0 " ) ; 



int action: ON / 01 

OFF / 00 



i n t num : 



PIC / 00 
08 J / -1 
1 - 10 



blink 

stop blinking action 

oicture 
object 
e 1 emen t s 



To blink the entire picture: 

blink(action,PIC); 

✓ 

To blink a specific object: 

bl ink(action,O0J," objname")? 

To blink elements of a specific object: 

bl ink(action,num,"objname","elel","ele2", . . . ) ; 



DESCRIPTION: 

The blink mode for the entire oicture, a sinqle ob- 
ject or any number of elements of a specific object, 
can be turned on or off. 

M odifying the blink mode of an object affects all ele- 
ments linked to that object. 

The parameter 'num' specifies the number of element 
names oeing passed in this routine and can vary 
between 1 and 10. 



DIAGNOSTICS: 

All errors will be printed on the PDP-11 terminal 
screen. 



CAUSE 

Specified objname does not 
exist 



1 13 



ERROR 

E-5 



ACTION 

Return 



D 1 ink 



blink 



E -fe 


Soec i f i ed 


el ement does 


not 


Skip 




exist 






element 


E-13 


Parameter 


'num' not -1 


to 10 


num - 10 


E -22 


Element not linked to 




Skip 




soec i tied 


object 




e 1 ement 


E-2U 


Improoe r 


action value 




action = OFF 



1 1 a 



cge t 



cget 



NAME : 

cget - get ASCII characters from the VG keyboard 
SYNOPSIS : 

cget (buffer, length, xpos,yoos) ; 
char * bu f f e r ; 
i n t length; 
float xdos , ypcs ; 



DESCRIPTION: 

This routine allows for buffered input from the VG 
keyboard to be displayed on the display screen and 
inserted in a user-supplied buffer. Parameters allow 
for the Positioning of the display buffer on the 
screen in absolute coordinates. The length of the 
use r-suco 1 i ed buffer must be specified in the parame- 
ter 'length'. 

A blinking cursor indicates the beginning of the 
buffer and the character size. Characters may be 
entered into the buffer and onto the screen up to a 
maximum of either 121 characters or the size of the 
supplied user buffer, whichever is smaller. 

Contents mav be erased from the screen and the user 
buffer bv repeated cntrl-a keystrokes. A C/R will 
terminate the input strina, delete the display of the 
buffer contents, and insert a ' \ 0 ' as the next charac- 
ter in the user buffer to indicate termination of the 
s t r i nq . 

A listing of the ASCII character code for every key- 
board entry is listed on the following page. 



DIAGNOSTICS: 

All errors will be printed on the PDP-11 terminal 
screen. 

ERROR CAUSE ACTION 

E-R Object limit exceeded Return 

E - 1 5 Specified xdos out-of-bounds xpos - xmin 

or x ma x 



1 15 



cge t 



c ge t 



E - 1 o Specified yoos out-of-bounds 

E-20 Either 121 characters entered 
or user buffer limit reached 



ypos = ymin 
or y ma x 
Wait for CR 
or CNTRL-A 



ALSO SEE: 

i get , f get 



OCTAL 


CHARACTER 


GENERATED 


VG 

KEYBOARD 


CODE 




SYMBOL 


SYMBOL 


000 


NULL 


( i qno r ed ) 


t) Ctrl 


00 1 


SO erase last char . 


A Ctrl 


002 


STX 


(ignored) 


B Ctrl 


003 


ETX 


( ianored) 


C Ctrl 


ooa 


EOT 


( i qnored) 


D Ctrl 


005 


ENQ 


( ignored) 


E Ctrl 


006 


ACK 


( ignored) 


F Ctrl 


007 


BEL 


( i qno red) 


G Ctrl 


010 


BS 




BS 


01 1 


HT 


(LF, cent ) 


I Ctrl 


012 


LF 




LF 


013 


VT 


(top, cent ) 


K Ctrl 


0 1 a 


FF 


(top, left) 


L Ctrl 


015 


NL 


(CR, LF) 


CR 


0 1 6 


SE 


( ignored) 


N Ctrl 


017 


SI 


( i qnored ) 


0 Ctrl 


020 


OLE 


(clear queue ) 


P Ctrl 


021 


DC 1 


(-LF) 


Q Ctrl 


022 


DC2 


(-SZ) 


R Ctrl 


023 


DC 3 


( +SZ ) 


S Ctrl 


02a 


DCa 


(terminate) 


T Ctrl 


025 


NAK 


( i gno r ed ) 


U Ctrl 


0 2o 


SYN 


( i qnored ) 


V Ctrl 


027 


ETB 


( ignored) 


W Ctrl 


030 


CAN 


( i gno r ed ) 


X Ctrl 


031 


EM 


(ignored) 


Y Ctrl 


032 


SUB 


( ignored) 


Z Ctrl 


033 


ESC 


( escape ) 


( Ctrl 


03a 


FS 


( ignored) 


\ Ctrl 


035 


GS 


( ignored) 


1 Ctrl 


036 


RS 


( ignored) 


A ctrl 


037 


US 


(ignored) 


Ctrl 


0a0 


Space 




sp bar 


0 a l 


1 

• 




l shift 


0 a 2 


If 




2 shift 
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cget 



043 


a 


3 shift 


044 


$ 


4 shift 


045 


% 


5 shift 


046 


& 


6 shift 


047 


t 


7 shift 


050 


( 


8 shift 


051 


) 


9 shift 


052 


★ 


: shift 


053 


+ 


; shift 


054 


f 


t 


055 


- 


- 


056 


• 


• 


057 


/ 


/ 


060 


0 


0 


061 


1 


l 


062 


2 


2 


063 


3 


3 


064 


4 


4 


065 


5 


5 


066 


6 


6 


067 


7 


7 


070 


8 


8 


071 


9 


9 


072 


• 

m 


• 

• 


073 


r 


• 


074 


< 


, shift 


075 


- 


- shift 


076 


> 


. shift 


077 


9 


/ shift 


100 


3 


a 


101 


A 


A Shift 


1 02 


B 


B shift 


103 


C 


C shift 


104 


0 


D shift 


105 


E 


E shift 


106 


F 


F shift 


107 


G 


G s n i f t 


1 1 0 


H 


H Shift 


1 1 1 


I 


I shift 


112 


J 


J shift 


113 


K 


K shift 


1 1 4 


L 


L shift 


115 


M 


M shift 


1 16 


N 


N shift 


117 


0 


0 shift 


120 


P 


P shift 


121 


Q 


G shift 


122 


R 


R shift 


123 


S 


S shift 


124 


T 


T shift 


125 


U 


U shift 


126 


V 


V shift 



cget 



1 1 7 



127 

130 

131 

132 

133 

13^ 

135 

136 

137 

l U0 

1 a l 

1«2 

l a 3 

1 aa 

1«5 

1 a6 

l a 7 

150 

151 

152 

L53 

15a 

155 

156 

157 

160 

161 

162 

163 

16 a 

165 

166 

167 

170 

171 

172 

173 

17a 

1 75 

176 

177 

2ao 

2a 1 

2 a 2 

2a3 

2 aa 

2a5 

2a6 

2a7 

250 

251 

252 



cget 



W 

X 

r 

z 

[ 

\ 

1 

^ C suoersc riot) 

— (subscript) 

* 

a 

b 

c 

d 

e 

f 

d 

h 

i 

j 

k 

1 

rr 

n 

0 

D 

q 

r 

S 

t 

u 

V 

w 

X 

y 

z 

( 

i 

i 

} 



de 1 



fl shift 
X shift 

Y shift 
Z shift 
[ 

\ 

1 

A 

3 shift 
A 
8 
C 
0 
E 
F 
G 
H 
I 
J 
K 
L 
M 
N 
0 
P 
G 
R 
S 
T 
U 

Y 

w 

X 

Y 
Z 

( shift 
\ shift 
1 shift 
A shift 
OEL 



O space spec 



* 




1 


shift 


spec 


H 




2 


shi ft 


spec 


O 




3 


s h i ft 


spec 


t 




a 


shi ft 


spec 


V 


(centered) 


5 


shift 


spec 


S 




6 


shift 


spec 


r 




7 


shift 


spec 


c 




0 


shift 


spec 






9 


shift 


spec 


to 


(subscript ) 


• 

• 


shift 


spec 



l 1 8 



cge t 



253 


T 




; shift spec 


25a 


4 




» spec 


255 






- spec 


256 


% 




. spec 


257 


n 




/ spec 


260 


o 




0 spec 


261 






1 spec 


262 


V- 




2 spec 


263 


□ 




3 spec 


269 


♦ 




9 spec 


265 


A 


(centerea) 


5 spec 


266 


9 




6 spec 


267 


L 




7 spec 


270 


U 




8 spec 


27 1 


n 




9 spec 


272 


* 


(center dot) 


: spec 


273 


X 




; spec 


279 


4* 




/ shift spec 


315 


(9 




M shift spec 


316 


»\ 




N shift soec 


317 


Cl 




0 shift spec 


320 


* 




P shift spec 


321 


a 




Q shift spec 


322 


4> 




R shift spec 


323 


X 




S shift spec 


329 


9 




T shift spec 


325 


1 




U shift spec 


326 


i 




V shift spec 


327 


A 




W shift spec 


330 


r 




X shift spec 


331 


r 




Y shift spec 


332 


- 




Z shift spec 


333 


L 




[ spec 


339 


•=» 




\ spec 


335 


k 




1 spec 


33t> 


— 




A spec 


337 


• 




_ spec 


390 


U-4 


( b 1 inking) 


3 shift spec 


391 


4 




A soec 


392 


0 




B spec 


393 


7 




C spec 


399 


* 




0 spec 


395 


6 




E spec 


39b 


* 




F spec 


397 


y 




G spec 


350 






H spec 


351 


L 




I spec 


352 


\ 




J spec 


353 


/ 




K spec 


359 


X 




L spec 


355 


M 




m soec 


356 


V 




N spec 



1 19 



cge t 



cget 



357 


UJ 


0 


spec 




360 


X 


p 


spec 




361 


& 


Q 


spec 




362 


e 


R 


spec 




363 


r 


S 


spec 




36a 


r 


T 


spec 




365 


5 


U 


spec 




366 


o 


V 


spec 




367 


J 


w 


spec 




370 


• 


X 


spec 




37 1 


* 


Y 


spec 




372 


V 


Z 


spec 




373 


r 


[ 


spec 


shift 


37a 


i 


\ 


spec 


shift 


375 


■i 


1 


spec 


shift 


376 




As 


spec 


shift 


377 


m 


DEL spec 



cge t 
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c h a r e 1 e 



c ha re 1 e 



name : 



chare I e • disolays an ASCII character string 
on the Vector General 



SYNOPSIS: 



charel e ( '* el ename'^charDt r , si z e * w d i r , si ant r xpos^ypos) ; 



i n t 


size: 


sz 


/ 


0000 






SZ1 


/ 


0100 






SZ2 


/ 


0 120 






SZ 3 


/ 


o i a o 






SZ« 


/ 


0160 


i n t 


w d i r : 


HOP 


/ 


0000 






VER 


/ 


0200 


i n t 


slant: 


SINT 


/ 00 






NSLNT 


/ 01 


float xpos 


e yoos; 





use previous character size 
size - 100 col x 60 lines 
size = 81 col x m lines 

si xe = 60 col x 30 lines 

size = 32 col x 16 lines 



write horizontally 
write vertically 

slant characters 
no slant characters 



xpos : VGREL - to output characters relative 

to the present beam position 
the parameter xpos should be 
replaced with VGREL and the 
parameter ypos omitted. 



DESCRIPTION: 

This routine displays the ASCII character string, 
specified by charptr, on the vector general screen. 
The characters can be output by specifying the desired 
coordinate starting point (xpos^yoos) or by outputting 
the string relative to the present beam location. The 
symbols available include formatting symbols and an 
extended character set. These can be included in any 
character string by including the proper identifying 
symbols. The character string formatting symbols are: 

KEYBOARD FORMAT 
SYMBOL 



sa 


backspace 


J moves 


back 


one character space 


A 


line feed 


• oosit 


ion center screen 


#8 


line feed 








«c 


position 


at too 


center 


of screen 


n D 


position 


at too 


left corner of screen 


*E 


carri age 


control 


r line 


feed 



c h a re 1 e 



charel e 



3F 


ignored 














4G 


i ano rea 














$H 


special 


character 










ft I 


neg . line 


feed; moves up one 


1 


i ne 




it J 


dec reases 


current 


charac ter 


s i 


z e by 


one 




i nc reases 


C u r r en t 


character 


s i 


ze by 


one 


Due to 


the extenaed 


character 


set a v a i 


1 ao 1 e 


on 



vector general/ all special character symbols are pre- 
ceded bv a pound sign. In order to have a pound sign 
appear on the screen, two pound signs (##) must appear 
in the character string. A list of the special char- 
acters available are listed on the next page under 
Extended Character Set. 



DIAGNOSTICS: 



All errors will be printed on the PDP-11 terminal 
screen. 



ERROR 


CAUSE 


ACTION 




E - 1 


Routine has been called 
within a draweleO block 


Return 




E -2 


No space available in 
d i s d 1 a y list 


Return 




E-a 


Incorrect ASCII character symbol 
found in character string 


None 




E-7 


Duplicate element name 


Return 




E-8 


Maximum number of elements 
exceeoed 


Return 




E - 1 5 


Soec i f i ed xpos out -of -bounas 


xpos = 
o r 


xmin 
x ma x 


E-16 


Soecified ypos out-of Pounds 


y pos = 
o r 


y m i n 
y ma x 


E - 35 


Improper ' wdi r ’ parameter 


write 


= HOR 


E - 36 


Improper ’slant' oarameter 


slant 


NSLNT 


E-37 


Imorcper 'size' oarameter 


size = 


SZa 
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c h a r e 1 e 



charele 





Extended Character Set 


DATA MEDIA 
KEYBOARD 
SYMBOL 


CHARACTER 


tfsoace 


a 


#1 


V 


9 " 


1) 


«L 

aS 


0 

£ 


*h 

a& 


V 

; 


a ’ 


V 


#( 


Cm 


A) 


3 


a * 
a + 


10 

« 


a, 

a - 




3 . 


> 


a/ 




ao 


O 


a l 


* 


*2 




#3 


□ 


aa 




as 


A 
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c h a re 1 e 



chare 1 e 



36 


d 


3 7 


2 : 


38 


U 


39 


n 


3 : 


• 


• 

/ 


X 


3 < 


4- 


3M 


1 


«N 




«0 


n 


sP 


IT 


«Q 


O 


3R 


4> 


us 


1 


3 T 




3U 


i 


av 


f 


tf M 


A 


3X 


t 


3 Y 


r 


3Z 


— 


3 t 


L 


3\ 




a] 


H 


at 


— 


34 - 


0 



12a 



c h a r e 1 e 



c ha re 1 e 



u % 


Ui 


3a 


* 


*b 


e 


# c 


7 


3d 


£ 


3e 


6 


u f 


* 




r 


3 h 


i 


3i 


L 


* j 


\ 




/ 


3 1 


X 


3 m 


/« 


3n 


V 




a> 


3 D 


IT 


3a 


6 


3 r 


f 


3S 


<r 


3 t 


T 


3 y 


? 


3 v 


a 


3w 


J 

♦ 


3x 


O 


3y 


4 
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c h a re 1 e 



chare 1 e 



»z 
«{ 
* : 
3 > 



4 ~< 



41 



V 

r 

l 

4 



/- 
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c i pc 1 e 



circle 



NAME : 



circle - draw a circle 



SYNOPSIS : 



2-dimensional coordinate system 



VR/VA 
VRX/VAX 
VRY/VAY 
VRZ/VAZ 



ci rc 1 e ( d i r,centx,centy) ; 
ci rcle(dirzcenty); 
c i rc 1 e Cdi r ,cent x ) ; 
not allowed 



3-dimensional coordinate system 



VR/VA 
VRX/VAX 
VRY/VAY 
VRZ/VAZ 

i n t dir: 



C 

CC 



ci rcl e(di r/centx/centy/centz ) 7 
ci rcle(di r,centy»centz] / 
ci rcle(di r/centx/centz)? 
ci rcle(di r,centx, centy) ; 

/ 010 clockwise 

/ 004 counter-clockwise 



float cent x , centy , cent z ; 



DESCRIPTION: 

A circle is drawn from the oresent beam location about 
a center ooint. The location of the center ooint 
depends upon the SDecifiea vector type ana supplied 
center ooint parameter. The parameters passed for the 
center ooint of the circle are either relative or 
absolute values. The number and value of these param- 
eters are determined by the vector type selected in 
the previous call to setvector(). 

If the vector type is an absolute vector then the 
center ooint of the circle will be as given in tne 
parameter list, Auto-increment vector types will 
cause the center ooint to have the same coordinate 
value as the starting point for the designated auto- 
increment coordinate. Under absolute vector types/ 
parameters which fall outside the aefined coordinate 
system will assume a value of the nearest coordinate 
within the defined system. 

If the vector type is a relative vector the center 
ooint will be obtained by adding the centx/ centy/ and 
centz values to the startina ooint. As with absolute 
vectors/ auto-increment modes cause the center point 
to have the same coordinate value as the startina 
point for the designated auto-increment coordinate. 
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circle 



circle 



Under relative vector types, parameters which exceed 
one-half the coordinate range will be set to zero. 

Circles cannot be drawn by any of the four incremental 
vectors. 



DIAGNOSTICS: 



All errors will be orinted on the PDP-11 terminal 
screen. 



ERROR CAUSE 

E-l Routine has been called 

outside a draweleO block 

E-2 No soace available in 

display list 

E - 3 Draw direction not defined 

as either C or CC 

E-ll 3D not defined 

E-15 The x value was out -of "bounds 



E-16 The y value was out-of-bounds 

E — 1 7 The z value was out-of-bounds 



E-1R Illegal circle instruction 
from incremental vector 



ACTION 

Return 

Return 

a i r = C 

Re t u rn 
x = x m i n 
or x ma x 
or 0.0 
y - y m i n 
or yma x 
or 0.0 
z - z m i n 
or zma x 
or 0.0 
Return 



ALSO SEE: 

arc, setvector 
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c 1 r h i t 



NAME : 



cl '•hi t “ clear picture/ object /element lightpen hit 



SYNOPSIS : 

cl rhi t (nu®, "obj name" / "elename") ? 

int num: PIC / 00 clear all element lightpen hits 

OBJ / -1 clear lightpen hits on all 

elements of specified object 
ELE / +1 clear lightoen hit on specified 
element of specified object 

To clear all elements of lightpen hits: 
cl rhi t (PIC) ? 

To clear all elements of object 'tree': 
clrhit(06J»” tree")? 

To clear element 'branch5' of object 'tree': 
c 1 rhi t (ELE/ "tree", "branchS") ? 



DESCRIPTION: 

This routine clears lightoen hits on a single element/ 
group of elements/ or all elements. If PIC is soec i * 
fied/ all elements are cleared of lightpen hits. If 
OBJ is specified/ all elements attached to the speci- 
fied object are cleared of lightpen hits. If ELE is 
specified/ only the indicated element of the specified 
object is cleared of a liahtpen hit. Invalid parame- 
ters will result in no action being taken. 



DIAGNOSTICS: 



All errors 
screen. 



ill be printed on the PDP-11 terminal 



ERROR 


CAUSE 






ACTION 


E-5 


Indi cated 
exist 


ob j name 


does not 


Return 


E -6 


Indicated 

exist 


e 1 ename 


does not 


Return 


E-22 


Element not linked 
soec i fied object 


t 0 


Return 
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coo rosy s 



NAME : 

coordsys - define user coordinate system 
SYNOPSIS: 

coo rds y s ( d i m / m i n x / ma x x / m i n y / ma x y {/minz/maxzl ); 
int dim: 2 or 3 

float minx,maxx/miny.maxy,minz/maxz; 



DESCRIPTION: 

Defines a two or three dimensional cartesian coordi- 
nate system# of any scale/ for the user. The parameter 
'dim' specifies the number of dimensions reduired. If 
'dim' is 2 then only the range of x and y need to be 
spec i f i ed . 

minx must be strictly less than maxx. 
miny must be strictly less than maxy. 
minz must be strictly less than maxz. 

All subsequent user coordinate values are interpreted 
according to this user defined coordinate system. 

If coordsys!) is not called by the user the default 
values will be taken. The default coordinate system is 
three dimensional with x, y / z ranging from -100.0 to 
100.0. All coordinate values received will be inter- 
oreted according to these default values unless the 
coordinate system is redefined by the user. 



DIAGNOSTICS: 

Any values which fall outside of the defined coordi- 
nate system will produce an error messaqe specifying 
which coordinate value was out-of-bounds. If the 
value was an absolute coordinate/ the nearest coordi- 
nate within the defined coordinate system will be 
assumed. If the value was a relative value that was 
out -of ’bounds/ a value of zero will be assumed. 

All errors will be printed on the PDP-11 terminal 
screen. 



coordsy s 



coordsys 



ERROR 
E-l 1 



CAUSE 

Dimension not SDecified as 
2D or 3D 



ACTION 

Return 
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c opy e 1 e 



conve 1 e 



N A M E ! 



copye 1 e - specify additional names to be used 

in referencing a specific element block 



SYNOPSIS: 

copyele(num, M elename''/" namel", "name2", , "narelO") ; 

i n t num : 1 to 10 



DESCRIPTION: 

This routine allows the user to give several unique 
names to a specific element block. In this manner/ a 
user can link one element to an object several times 
and can uniauely reference each occurrence of the 
element within the object. 

The parameter 'num' specifies the number of element 
names being passed in this routine and can vary 
bet ween 1 and 10. 



DIAGNOSTICS: 

All errors will be printed on the PDP-11 terminal 
sc r een . 



ERROR 

E-6 


CAUSE 
Soec i f i ed 


el en ame 


does not 


ACTION 

Return 


E-7 


exist 
Duo 1 i c a t e 


e 1 emen t 


name 


Skip 


E-8 


Maximum number of 


el emen t s 


el emen t 
Return 


E-10 


exceeded 

Parameter 


'nufp* not i to 10 


num - 10 



ALSO SEE: 

drawe 1 e / object 
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c u r so r 



NAME : 



cursor - activate/deactivate display of specified 
dev i ce cursor 



SYNOPSIS: 



cursor(oev,act ion) ; 








i n t 


dev: LPEN / 


00 


1 i ah t pen 








TRK / 


01 


t rac kba 1 1 








JOY / 


02 


j o y s t i c < 






i n t 


action: OFF 


/ 00 


turn cursor 


d i so 1 ay 


off 




ON 


/ 01 


turn cursor 


d i so 1 ay 


on 



DESCRIPTION: 

This routine will activate/deactivate the aisolay of 
the soecified device cursor depending on the specified 
* act ion' value. 

The trackball and joystick cursors are displayed as 
olinking plus signs. The trackball cursor is two 
dimensional and may be moved along the X-Y plane. The 
joystick cursor is drawn two dimensionally but can 
move in all three dimensions. As the joystick cursor 
moves alonq the Z axis its intensity cueing is affect- 
ed. Both trackball and joystick cursors may be moved 
without being displayed. 

The liqhtDen cursor is a small non-blinking octogon. 
It is drawn in two dimensions and can only move along 
the X-Y plane. The lightoen mav onlv be moved while 
beina displayed. Lightoen cursor movement may be 
accomplished in one of two speeds# depending upon 
whetner the lightoen sense switch is on. 



DIAGNOSTICS: 



All errors will 


be 


printed on 


the PDP-11 terminal 


screen. 










ERROR 


CAUSE 






ACTION 


E-2« 


Imorooer 


’action* value 


Return 


E-27 


Imo rooe r 


' dev ' 


number 


Return 



dial 



dial 



NAME : 

dial - return value of specified dial 

SYNOPSIS : 

dial(num); 
i n t num : 1-10 

double d i a 1 ( ) ; 



DESCRIPTION: 



This routine returns 
value from -1.0 to +1.0 
(0) is returned to the 
is soecified. 



to the user a double precision 
of the specified dial. A zero 
user if an improper dial 'num' 



To obtain the double precision value from 
the function declaration "double dial ( ) ? '* 
in the users program. 



this routine 
must be made 



DIAGNOSTICS: 

All errors will be printed on the PDP-11 terminal 
screen. 

ERROR CAUSE ACTION 

E -25 Improper dial 'num' Return 0.0 
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a i so] ay 



display 



NAME : 



disoiay - activate/deactivate display of the entire 
picture, an object* or an element 



SYNOPSIS: 

display (act i on * t y oe * " ob j name " * " e 1 e 1 " * . . . . * " e 1 e 1 0 " ) ; 

int action: ON / 01 turn display on 

OFF / 00 turn display off 

int tyoe: PIC / 00 entire picture 

OBJ / -1 specified object 
1 • 10 individual elements 

To activate display of entire picture: 
disolay(0N,PIC); 

To deactivate display of an object: 
di spl ay(0FF,08J, " o b j n a m e M ) * 

To deactivate display of 3 elements in an object: 
di sol ay (OFF, 3,” ob j name” , " e 1 e 1 M , " e 1 e2 ” , "ele3"); 



DESCRIPTION: 

This routine will activate or deactivate the display 
of the entire picture, an object, or elements within 
an object depending upon the ’action* oarameter. 
Unlike the erased and removed routines, this routine 
does not affect the el ement-ob j ect relationships, but 
simoly turns the display of its Parameters either on 
or off* The routine should not be confused with the 
vgoicture() routine which must be called to initiate 
the disoiay of elements. 



DIAGNOSTICS: 

All errors will be orinted on the PDP-11 terminal 
screen. 

ERROR CAUSE ACTION 

E-5 Specified ob j name not found Return 

E-6 Specified element not found Skip 

element 
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display 



display 



E — 1 8 Parameter 'tyoe' not -1 to 10 
E-22 Element not linked to 
specified object 



ALSO SEE: 

vgoicture» erase/ remove 



type = 10 
Skip 

el emen t 
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d r awe 1 e 



drawe 1 e 



NAME: 



d r a we 1 e _ start a draw element block 
SYNOPSIS: 

drawel e( M el ename " ) 1 



DESCRIPTION: 

This routine soecifies the beainninq of a draw element 
block. It associates a unique name with the qrouo of 
draw instructions that fall in between this call and a 
call to endeleO. The resulting picture segment will 
then be referenced by the name specified as the ele~ 
ment name in this routine. 

A user may want to reoeat a specific element block 
structure several times within one object. Instead of 
specifying several element blocks which describe the 
same structure a user can indicate a group of names 
whicn refer to one specific element block. These 
uniaue names each referring to the same structure can 
then be linkeo to an object/ and each can oe uniauely 
referenced. This association of several names with one 
element can be accomplished by the routine copyeleO. 



DIAGNOSTICS: 

All errors will be printed on the PCP-11 terminal 
sc r een . 



ERROR 


CAUSE 


ACTION 


E-l 


Routine has been called 
within a drawel e( ) block 


Return 


E-2 


No space available 
in display list 


Return 


E-7 


Duplicate element name 


Return 


E-8 


Maximum number of elements 
exceeded 


Return 



ALSO SEE: 



copy e 1 e » 



object 



ende 1 e 



ende 1 e 



NAME : 



ende 1 e - end of the current element block 



SYNOPSIS: 

ende 1 e ( ) ; 



DESCRIPTION: 

Specifies the termination of a list of draw instruc- 
tions describing a soecific element. The picture seg- 
ment described by a grouo of draw instructions that 
fall between a draweleO and endeleO call will be 
referenced by the name specified in the draweleO 
call. 

A new element block cannot oegin until the previous 
clock has been orooerly terminated by a call to en- 
deleO . 



DIAGNOSTICS: 

This routine must be called to properly end a draw 
element block. If a block is not properly terminated 
prior to the beginning of a new element block/ all 
draweleO calls will be ignored and any araw instruc- 
tions that follow will be associated with the element 
block that has not been terminated. 

All errors will be printed on the PDP-11 terminal 
screen. 

ERROR 
E - 1 



CAUSE 

Routine 

outsioe 



has been called 
a draweleO block 



ACTION 

Return 
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NAME : 



erase - erase the soec i f i ecf Portions of the picture 



SYNOPSIS: 

erase (num , "ob j name" , M el e 1 M , ”e 1 e2 M / * . . . , "el e 1 0 M ) ? 

int num: PIC / 00 all elements 

OBJ / -1 all elements within specified 
object 

1 * 10 specified elements within 
specified object 

To erase the entire picture: 
erase(PIC) ; 

To erase a specific object: 
eraseCOBJf "objname") / 

To erase elements of a specific object: 

e r a s e ( n u m , M o b j n a m e " , " e 1 e t " / M e 1 e 2 " * . . ) ; 



DESCRIPTION: 



The entire picture, specified object 
elements of a specific object , will be 
vector general display screen* The 
exist. To rea i splay any portion of the 
the appropriate e 1 emen t -ob j ec t linking 
done by the user . 



or the listed 
erased from the 
e 1 emen t s still 
erased picture/ 
must aga i n oe 



The parameter ’num' specifies the number of 
names being passed in this routine and 
between 1 and 10* 



el e m en t 
may vary 



DIAGNOSTICS: 

All errors will be printed on the PDP-11 terminal 



screen. 

ERROR 


CAUSE 






ACTION 


E-S 


S o e c i f i e d 
exist 


ob j name 


does not 


Return 


E-6 


Soec i f i ed 
exist 


e 1 emen t 


does not 


S k i o 

el emen t 



erase 



erase 



ALSO 



E-18 Parameter 'num' not -1 to 10 
E-22 Element not linked to 
specified object 



num - 10 

Skip 

e 1 emen t 



SEE : 

remove, display, object 



errormsg 



errormsg 



NAME : 



errormsg - orint error messages on PDP-11 terminal 
screen 



SYNOPSIS: 

errormsa(action); 

int action: ON / 01 print error messages 

OFF / 00 do not orint error messages 



DESCRIPTION: 

All error messages will automatically be orinted on 
the D DP-11 terminal screen. The user can control the 
printing of error messages during any portion of a 
program by calling this routine. 



l a i 



f ge t 



f get 



NAME : 



fget “ get a floating point number from the VG 
keyboard 

SYNOPSIS : 

fget( [num,xDos»ypos] ); 

int num: ABS / 01 absolute coordinate indicator 

float xDos,ypos» (x,y) absolute coordinate 

To return a floating do int number and begin inout 
disolay buffer at (50.0,75.0) absolute: 

fget (ABS, 50. 0,75.0) ; 

To return a floating point number and begin input 
display buffer at (xmin,ymin) absolute: 

f get ( ) ; 

DESCRIPTION: 

This routine returns to the user a floating do int 
number from the VG keyboard. The routine is similar 
to getf() and in fact uses qetf() to accomplish its 
task. 

The optional parameters allow the user to Position the 
input diSDlav buffer anywhere on the display screen. 
The 1 x po s ' ana 'y°os' parameters are absolute floating 
point coordinates. If no parameters are given the 
input buffer will begin at (xmin,ymin). Coordinate 
parameters which fall outside the cefineo coordinate 
system will assume a value of the nearest coordinate 
within the defined system. 

The input disclay buffer is drawn with the help of a 
call to the cget ( ) routine. The input display buffer 
has a maximum size of 20 characters before an error 
message is displayed. 

To obtain the floating ooint value from this routine 
the function declaration "float f ge t ( ) ; " must be made 
in the users program. 
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f ge t 



f qe t 



DIAGNOSTICS: 



All errors will be printed of the PDP-11 terminal 
screen . 



ERROR 


CAUSE 






ACTION 


E- 1 5 


Specified 


XDOS 


ou t -o f -bounds 


xpos - xmin 
or xmax 


E-16 


Spec i f i ed 


ypos 


out -o f -bounds 


ypos - y m i n 
or y ma x 


E-33 


Buffer limit of 
reached 


20 characters 


Wait for C R 
or CNTRL-A 



ALSO SEE: 

i ge t / cge t 
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f sman 



NAME : 



f sman - check function switch depressed 



SYNOPSIS : 

fsman(num) ; 
int num : 0 - 31 



DESCRIPTION: 

This routine checks the status of the specified func- 
tion switch and returns a one (1) if deoressed and a 
zero (0) if not depressed. Unlike fstogO* lamps are 
not lighted by this routine and a one is returned only 
so long as the switch is physically depressed. 

It is not recommended that both fstogO and fsmanO oe 
used in the same program. Due to the operation of the 
routine fstogO/ if both routines are used the lamp 
status on switches aueri ed by fsmanf) should be disre- 
ga rded . 

A zero is returned if an improper function switch 
’num* is specified. 



DIAGNOSTICS: 



All errors will be printed on the PDP-11 terminal 
screen. 



ERROR CAUSE 

E-23 Improper function switch 
’num* soecifi ed 



ACTION 
Return 0 



ALSO SEE: 

f s t og / 1 amp 
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f s t og 



f Stoq 



NAME : 



fstog - check function switch togqle 

SYNOPSIS: 

f s t og ( num ) ; 
i n t num : 0 - 31 

DESCRIPTION: 

This routine chec<s tne specified f unctii on switch and 
returns a one (1) and lights the aooropr i ate lamp on 
the odd (lst/3rd,5th,....) depressions of the function 
switch. The return value and lamp status remain the 
same until the next even ( 2nd , 4 t h , 6 t h , . • . . ) depression 
of the function switch whereupon a zero (0) is re- 
turned and the lamp ext i naui shed. 

It is not recommended to use botn fstogO and fsmanO 
routines in the same program; however, if both are 
used/ disregard the lamp status of function switches 
queried oy fsman(). 

A zero is returned if an improoer function switch 
' num • is spec i f i ed . 

DIAGNOSTICS: 

All errors will be orinted on the PDP-11 terminal 
screen. 

ERROR CAUSE ACTION 

E-23 Improper function switch Return 0 

1 num 1 soecified 



ALSO SEE: 

f sman , 1 amo 



1 as 



i get 



i get 



NAME: 



iget - get an integer from the VG keyboard 
SYNOPSIS: 

iget( tnum,xoos/voos] ) ; 

int num: A9S / 01 absolute coordinate indicator 

float xoos/ ypos? (x, y) absolute coordinate 

To return an integer and begin input display buffer at 
(-25.0/17.0) absolute: 

iget (ABS,-25.0, 17.0) ; 

To return an integer and begin incut display buffer at 
( x m i n , y m i n ) absolute: 

iaetO; 



DESCRIPTION: 

This routine returns to the user an integer from the 
VG keyboard. The routine is similar to g e t i ( ) and in 
fact uses geti() to accomplish its task. 

The optional parameters allow the user to position the 
input display buffer anywhere on the disolay screen. 
The 'xpos* ana f yoos* parameters are absolute floating 
point coordinates. If no parameters are given the 
input disolay buffer will begin at (xmin/ymin). Coor- 
dinate oarameters which fall outside the defined coor- 
dinate system will assume a value of the nearest coor- 
oi nate within the defined system. 

The input disolay buffer is drawn with the help of a 
call to the cgetC) routine. The input disolay Puffer 
has a maximum size of 20 characters before an error 
message is displayed. 



DIAGNOSTICS: 

All errors will be orinted on the PDP-11 terminal 
screen. 

ERROR CAUSE ACTION 

E — 1 5 Soecified xpos out of bounds xoos = xmin 

or x ma x 
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i ge t 



i get 



E-16 


Soec i f i ed yoos 


out 


of bounds 


yoos 


E-33 


Buffer limit of 


20 


characters 


rta i t 




reached 






o r 



ALSO SEE: 

f ge t » cget 



1«7 



= y m i n 
or ynax 
for CR 
CNTRL-A 



intoffset 



intoffset 



NAME : 



intoffset - object intensity offset 



SYNOPSIS : 

intoffset("objname"/val )/ 
float val: 0.0 to 1.0 



DESCRIPTION: 

The intensity ranae of the specified object is deter- 
mined by the parameter 'val'. If 'val' is one/ the 
maximum intensity range is achieved. If the value is 
zero/ the intensity is constant and the image has no 
dept h-cue i ng . 



DIAGNOSTICS: 

All errors will be printed on the PDP-11 terminal 
screen. 

ERROR CAUSE ACTION 

E-5 Specified object does not Return 

exist 

E-30 Parameter 'val' not 0.0 to 1.0 Return 



ALSO SEE: 

i n t sc a 1 e 



1 as 



i n t sc a 1 e 



i n t sc a 1 e 



NAME 



intscale - modify object intensity seal e 



SYNOPSIS 



intscale("objname"*va1 ,cut ) 



float va 1 : 0.0 to 1.0 



i nt cut 



0 o r 1 



DESCRIPTION: 



The intensity ranoe of an object* which aives a 
three-dimensional object its depth cueing, is deter- 
mined by the parameter 'val'. The range of ' val ' is 
from zero to one. If 'val' is one the maximum intensi- 
ty ranae is obtained; if it is zero the object has no 
deot h cuei ng . 

The parameter 'cut' provides for the use of a screen 
cut-off plane. If the value of 'cut' is one then the 
cut-off plane provisions are in effect. If the value 
is zero there will be no screen cut-off plane. 



All errors will be printed on the PDP-11 terminal 
screen. 



DIAGNOSTICS 



ERROR CAUSE 

E-5 Specified objname does not 



ACTION 

Return 



exist 



E-30 Parameter 'val' not 0.0 to 1.0 

E — 3 1 Parameter 'cut' not 0 or l 



Return 

Return 



ALSO SEE 



intoffset 



1 amc 



1 amp 



NAME : 



lamp ” 1 i gh t / e x t i ngu i s h specified lamp 

SYNOPSIS : 

lamp (num, act ion); 
int num: 0 - 31 

int action: OFF / 00 turn lamp off 

ON / 01 turn lamp on 

DESCRIPTION: 

This routine 1 i gh t s/ex t i ngu i shes the specified lamp 
deoendi ng on the soec i f i ed ’action’ parameter. An 
'action' value of OFF will extinguish the specified 
lamp, while a value of ON will light the appropriate 
lamp. An improper lamp 'num' or 'action' will result 
in no action being taken. 



DIAGNOSTICS: 

All errors will be printed on the PDP-11 terminal 
screen. 

ERROR 
E-23 
E-aa 



ALSO SEE: 

f s t og 



CAUSE 
I mo r ooe r 
Improoe r 



lamp 'num' specified 
'action' value specified 



ACTION 

Return 

Return 



ISO 



1 gh t Den 



1 gh t Den 



NAME : 



Ightpen - set lightDen sensitivity of 

the p i c t u re , ob j ec t or elements 



SYNOPSIS: 

IghtpenCact ion,num, ''objoame'S "el el" / M e1e2'\ , "el elO") 

int action: ON / 01 set liqhtpen sensitivity 

OFF / 00 clear liqhtpen sensitivity 

int num! PIC / 00 picture 

OBJ / -1 object 

1 - 10 elements 

To set sensitivity of the entire Picture: 

IghtpenCact ion, PIC); 

To set sensitivity of an object: 

IghtpenCact ion, OBJ, "objname"); 

To set sensitivity of elements of a specific object: 
IghtpenCact ion,num/ "objname"/'el el"f "ele2", . . . ) ; 



DESCRIPTION: 

The user can specify which picture segments will be 
lightDen sensitive. These elements designated as 
1 ightpen sensitive will be affected by liqhtpen in- 
teraction with the vector general display screen. 

The parameter 'num' specifies the number of element 
names being passed in this routine and may vary from 1 
to 10. 



DIAGNOSTICS: 



All errors will be printed on the PDP-11 terminal 
screen. 



ERROR CAUSE 

E-5 Specified objname does not 

exist 

E-6 Specified element does not 

exist 



ACTION 

Return 

Skip 

e 1 ement 
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1 gh t pen 



1 gh t oen 



E — 1 3 Parameter 'num' not -1 to 10 
E -22 Element not linked to 
specified object 



ALSO SEE: 

oenh i t r c 1 rh i t 



num - 10 

Skip 

el emen t 
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line 



NAME : 



line - draw a line 



SYNOPSIS: 

2- dimensional coordinate system 

VR/VA : 1ine(parx,pary); 

VRX/VAX: 1 ine(oary) ; 

VRY/VAY: 1 ine(oarx); 

VRZ/VAZ: not allowed 

3- dimensional coordinate system 

VR/VA r li ne ( oa r x , pa ry , pa r z ) ; 
VRX/V^X: 1ine(oary,parz); 

VRY/VAY: 1 ine(oarx,Darz) ; 

VRZ/VAZ: 1ine(oarx,pary); 

float parx/oary,oarz? 



DESCRIPTION: 



A line is drawn from the present beam location to a 
position ( x , y , z ) . The location of ( x , y , z ) depends 
upon the vector tyoe and the specified parameters*. 

If the vector type is absolute, the location of 
( x , y , z ) will be (parx,oary,parz). If an auto- 
increment mode is in effect, the designated auto- 
increment coordinate is left out of the parameter list 
and is incremented by the designated increment to find 
the termination point of the line. Under absolute 
vector tyoes, parameters which fall outside the de- 
fined coordinate system will assume a value of the 
nearest coordinate within the defined system. 



If the vector t yoe i s 
( x , y , z ) will be the present 
specified parameter values, 
auto-increment modes do not 
auto-increment coordinate 
Under relative vector tyoes, 
one-half the coordinate range 



relative, the location of 
beam location plus the 
As with absolute vectors, 
specify the designated 
in the parameter list, 
parameters which exceed 
will be set to zero. 



DIAGNOSTICS: 

All errors will be printed on the PDP-11 terminal 
sc reen . 
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line 



1 i ne 



ERROR 


CAUSE 


ACTION 




E-t 


Routine has been called 
outside a drawel e( ) block 


Return 




E-2 


No space available in 
display list 


Return 




E-15 


Parameter oarx out-of-bounds 


oarx = 
o r 
o r 


x m i n 
x m a x 
0.0 


E-16 


Parameter pary out-of-bounds 


oa r y = 
or 
o r 


y mi n 
y ma x 
0.0 


E-17 


Parameter oarz out-of-bounds 


oarz = 
o r 
o r 


zm i n 
zmax 
0.0 



ALSO SEE: 

setvector 
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m a n i n t 



mani nt 



NAME : 



m a n i n t - Clear or return manual interrupt count 

SYNOPSIS: 

man int (action); 

int action: CLEAR / 00 set count to zero 

COUNT / 01 return count 

DESCRIPTION: 

This routine either returns the present value of the 
manual interrupt count or resets the count to zero. 
Each time the manual interrupt function switch is 
depressed the manual interrupt count is incremented by 
one . 

An ‘action* value of COUNT will return to the user the 
present manual interrupt count/ while a value of CLEAR 
will reset the count to zero. An improper ’action* 
value will result in returning a value of zero but not 
affecting the manual interrupt count. 



DIAGNOSTICS: 

All errors will be printed on the PDP-11 terminal 



screen. 






ERROR 


CAUSE 


ACTION 


E-24 


Improper 'action' value 


Return 0 
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move 



NAME : 



move - move to the soecified location 



SYNOPSIS : 



2-d i men s i ona 1 coordinate system 



VR/VA 
VRX /VAX 
VRY/V AY 
VRZ/VAZ 



move(parx,pary) ; 
move (oary) ; 
move (oarx ) * 
not all owed 



3 -d i men s i on a 1 coordinate system 
VR/VA : mo v e ( oa r x * oa r y * pa r z ) ; 

VRX/VAX: move(oary*parz)* 

VRY/VA Y : move (oar x * pa rz ) ; 

VRZ/VAZ: mo v e ( oa r x * pa r y ) ; 

float oa r x * oa r y * pa r z ; 



DESCRIPTION: 



The beam is moved from the oresent position to a posi- 
t ion (x,y,z). The location of (x*y*z) depends uoon 
the vector type and the specified parameters. 



If the vector tyoe is absolute* the location of 
( x * y * z ) will be ( oa r x * pa ry * pa r z ) . If an auto- 
increment mode is in effect* the designated auto- 
increment coordinate is left out of the parameter list 
and is incremented by the designated increment to find 
the termination point. Under absolute vector types* 
parameters which fall outside the defined coordinate 
system will assume a value of the nearest coordinate 
within the defined system. 



If the vector tyoe is relative* the location of 
( x * y * z ) will be the oresent beam location plus the 
soecified parameter values. As with absolute vectors* 
au t o- i nc remen t modes do not specify the designated 
au t o- i nc rement coordinate in the oarameter list. 
Under relative vector types* parameters which exceed 
one-half the coordinate range will be set to zero. 



D I AGNOSTICS : 

All errors will be printed on the PDP-11 terminal 
screen. 
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move 



move 



ERROR 


CAUSE 


ACTION 




E-l 


Routine has been called 
outside a drawel e() block 


Return 




E-2 


No soace available in 
display list 


Return 




E - 1 5 


Parameter par* out-of-bounds 


oarx = 
o r 
o r 


x m i n 
x m a x 
0.0 


E-lb 


Parameter oary out-of-bounds 


oary = 
o r 
o r 


y m i n 
y ma x 
0.0 


E-l 7 


Parameter parz out-of-bounds 


oarz = 
o r 
o r 


2 m i n 
2 max 
0.0 



ALSO SEE: 

setvector 
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od j ec t 



object 



NAME : 



object - link elements to specified object name 
SYNOPSIS: 

object (num, "o'd j name" , " e 1 e 1 " , " e 1 e2 e 1 e 1 0 " ) ; 

int num: 1 - 10 



DESCRIPTION: 

Associates with the named object each of the listed 
elements. This picture segment* or element grouping 
will be referenced by the object name specified in 
this routine. 

Every element must be linked to at least one object in 
order for it to be displayed on the Vector General 
screen. A user can link one or more element names to 
an object. Elements can be linked to an object by one 
or several calls to this routine. An element can be 
linked to several different objects* or one element 
may be linked several times to the same object. 

If an object or element has been erased from the 
display screen* a user can redisplay the desired ob- 
ject or elements by again establishing the desired 
ob j ec t -e 1 emen t association. 

The parameter 'num* specifies the numoer of element 
names being passed in this routine and may vary from 1 
to 10. 



DIAGNOSTICS: 

All errors will be printed on the PDP-11 terminal 
screen. 



ERROR 

E-6 


CAUSE 

Soecified element 


does not 


ACTION 

Skip 


CO 

1 

UJ 


exist 

Maximum number of 


elements 


el emen t 
Return 


E-9 


exceeded 

Maximum number of 


objects 


Return 


E-12 

E-18 


exceeded 

Add element error 
Parameter 'num* not 1 to 10 


Return 
num - 1 0 


E-21 


Add object error 




Return 
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od j ec t 



object 



ALSO 



E-32 Element already linked 



Skip 

el emen t 



SEE: 

drawel e> cooyele, erase* remove 
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of f se t 



NAME 



offset - offset picture coordinate axis 



SYNOPSIS 



offset (xoffrycff) 



float xoff/yoff: “1.0 to +1.0 



DESCRIPTION: 



This routine will alter the oositioning of the entire 
picture on the display screen. Normal or default oic* 
ture oositioning is centered on the display screen and 
corresoonds to o f f set ( 0 . 0 , 0 . 0 ) . Both the X and Y axes 
may be altered with this routine. Parameters outside 
the range -1.0 to +1.0 will result in no altering of 
the specified coordinate axis. 



All errors will be printed on the PDP-11 terminal 
screen. 



DIAGNOSTICS 



ERROR CAUSE 

E - 1 5 Specified xoff value 
out-of-bounds 

E - 1 6 Specified yoff value 
ou t -o f -bounds 



ACTION 
Skip X axis 
altering 
Skip Y axis 
a 1 t e r i n g 



ALSO SEE 



t r an s 



1 60 



d e n hi t 



penh i t 



NAME : 

oenhit - determine if object/element lightpen hit 
SYNOPSIS: 

oenhi t (num, "objname" , "elename" ) i 

int num: OBJ / -1 check oenhit on object 

ELE / +1 check penhit on element 

To check for liahtoen hit on object 'tree': 

oenhi t (OBJ, "tree") ; 

To check for lightoen hit on element 'branch5' of 
object 'tree': 

oenhi t (ELE,"tree","branch5") ; 



DESCRIPTION: 

This routine checks to see if an object or element 
within an object has had a lightDen hit. The routine 
returns to the user a one (1) if there has been a 
lightoen hit on the element or object, otherwise a 
zero (0) is returned. When testing for a lightoen hit 
on an object only the first two oarameters are neces- 
sary, and a one is returned if any element within the 
object has hao a lightpen hit. 

The clrhitC) routine must be called to clear an object 
or element of lightpen hits. Invalid oarameters will 
result in a zero being returned to the user. 

For an element to register a lightoen hit the 
element's lightoen sensitivity must be activated with 
the 1 g h t P e n ( ) routine and the lightoen, with the sense 
switch selected, must be held over the element. 



DIAGNOSTICS: 



All errors will be orinted on the 
screen. 

ERROR CAUSE 

E-5 Indicated objname does not 

exist 

E-fe Indicated elename does not 

exist 



PDP-11 terminal 

ACTION 
Return 0 

Return 0 
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oenh i t 



penh i t 



ALSO 



E~22 Element not linked to 
specified object 



Return 0 



SEE: 

1 gh t pen , c 1 r h i t 
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place 



NAME : 



place - position object 
SYNOPSIS : 

o1ace("objname",xabS/yabs ( , z abs J ); 
float xaos,yabs,zabs» 

DESCRIPTION: 

The soecifiec objects with all its elements/ is posi- 
tioned at ab so 1 u t e _ 1 oc a t i on ( x abs / y abs / zabs ) . 

The z parameter is reauired only when the coordinate 
system is defined as three dimensional / and will be 
ignored if included under a two-dimensional system. 

DIAGNOSTICS: 



All errors will be orinted on the PDP-11 terminal 
screen. 



ERROR 


CAUSE 






ACTION 




E-5 


Specified 

exist 


object does not 


Return 




E - 1 5 


Soec i f i ed 


x ab s 


out -o f -bounds 


x abs = 
o r 


xmin 
x ma x 


E-lb 


Spec i f i ed 


y abs 


out -o f-bounds 


y abs = 
o r 


ymi n 
y m a x 


E - 1 7 


Soec i f i ed 


z ab s 


out-of-bounds 


zabs = 
o r 


zrr.i n 
zma x 



ALSO SEE: 

offset/ trans 
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posit 



DOS 1 t 



NAME : 



Dosit - return coordinate value of SDecified device 
cursor 



SYNOPSIS: 



Dosi t (dev>coord) ; 



int dev: LPEN 


/ 00 


light pen cursor 


TRK 


/ 01 


trackball cursor 


JOY 


/ 02 


j oyst i c k cursor 


int coord: X / 


00 


x coordinate 


Y / 


01 


y coordinate 


z / 


02 


z coordinate 



float DOsitU; 



DESCRIPTION: 

This routine returns to the user a floating point 
value of the SDecified cooroinate and device. The 
value returned is a value within the user SDecified 
coordinate system. 

This routine will return the present oosition of the 
device cursor even though the cursor may not be 
currently displayed. A coordinate value of zero is 
returned if an improper garameter is received. 

To obtain the floating point value from this routine 
the function declaration "float posit ():" must be made 
in the users program. 

DIAGNOSTICS: 



All errors will be printed on the PDP-11 terminal 
screen. 



ERROR 


CAUSE 


ACTION 




E-2 7 


Inprooer 'dev ' number 


Return 


0 . 0 


E-2S 


Improoer 'coo rd' number 


Return 


0.0 


E-29 


No 3D with LPEN or TRK 


Return 


0 . 0 



ALSO SEE: 

cu r so r 
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D r i n t v 



p r i n t v 



NAME : 



or intv - formatted orintf routine for V G display 



SYNOPSIS: 







1# 


arql, 


a r q2 * • . . . , a r g 1 0 ] 


) ; 


i n t 


size: SZ 


/ 


00 


use previous character si 




SZ1 


/ 


0 100 


size = 100 col 


x 60 lines 




SZ2 


/ 


0120 


size = 81 col 


x 4 1 lines 




SZ3 


/ 


0 1 uo 


size = o0 col 


x 30 lines 




SZ4 


/ 


0160 


size = 32 col 


x 16 lines 


i n t 


write: HGR 


/ 00 


hori zontal print ing 




VER 


/ 0200 vertical orinting 



i n t slant 



SLNT / 00 
NSLNT / 01 



slanted printing 
no slanted printing 



float xpos/yDOS? absolute coorai nates 

A sample printed at ( -25 . 0 , - 1 0 . 0 ) absolute: 

printvC'test ",SZ4, HOP, SLNT, -25.0, -10.0, 

M bravot5] = %d" , b ra vo [53 ) ; 



DESCRIPTION: 

This routine is a formatted print routine similar to 
the orintf () routine except output is to the VG 
disolay screen. The routine is a combination of the 
chareieO and printf () routines. The routine uses the 
first 6 parameters as the charel e ( ) routine does in 
positioning and initializing an element structure. 
Coordinate parameters which fall outside the defined 
coordinate system will assume a value of the nearest 
coordinate within the defined system. 

Unlike chareieO the routine allows multiple calls 
uoon the same element/ each call updating the 
element's character string. The routine allows for 
formatted outcut strings of uo to 100 characters be- 
fore an error message is displayed. 

Each new element declared in a printvO routine uses 
up 57 words of the available display list so care must 
be taken not to declare too many new elements in this 
routine. It should be remembered that an element may 
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o r i n t v 



print v 



be used repeatedly with this routine. 

Elements originally declared elsewhere as either vec- 
tor drawing elements or character drawing elements 
should not be used in this routine. In other words/ 
element names found in this routine should be unique 
and should not be found in other drawel e( ) or 
charel e( ) routines. 



DIAGNOSTICS: 

All errors will be printed on the PDP-11 terminal 



screen. 

ERROR 

E-2 


CAUSE 

No wore space available in 


ACTION 

Return 


E-8 


d i so 1 ay list 
Maximum numbe r 


of elements 


Return 


E - 1 5 


exceeced 
Paramet er xoos 


out-of-bounds 


x = x m i n 


E-16 


Parameter yoos 


ou t -o f -bounds 


or x m a x 
y = y m i n 


E-34 


Formatted output length 


or y ma x 
Chop to 1st 


E-35 


exceeds 100 characters 
Improper ’write* parameter 


10 0 c h a r 
-write = H0R 


E-36 


I mp rope r 'slant 


* oa r ame ter 


slant = 


E-37 


Improper 'size' 


parapet e r 


NSLNT 

size = SZ4 



ALSO SEE: 



c h a r e 1 e 



ds c a 1 e 



psca 1 e 



name : 



oscale - scale the picture 



SYNOPSIS: 

pscale(val ); 

float val: 0.0 to 1.0 



DESCRIPTION: 

This routine will scale the entire oicture. Normal or 
default picture scaling corresoonds to pscale(l.O). 
An improper oscaleO parameter will result in the pic- 
ture scale remaining the same as before calling this 
rout i ne . 



DIAGNOSTICS: 

All errors will be printed on the PDP-11 terminal 
screen. 

ERROR CAUSE ACTION 

E-30 Parameter 'val' not 0.0 to 1.0 Return 

ALSO SEE: 

scale 
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refresh 



refresh 



NAME 



refresh - change refresh rate 



SYNOPSIS 



ref resh (rate) 



int rate: 1 to 8 



DESCRIPTION 



This routine will change the refresh rate of the YG 
disolay screen. Normal or default refresh rate is 40 
Hz and corresoonds to refresh(3). To determine the 
refresh rate for different values use the following 
equa t ion: 



All errors will be printed on the PDP-11 terminal 
screen. 



120 / rate 



new refresh rate 



DIAGNOSTICS 



ERROR CAUSE 

E-30 Parameter 'rate' not 1 to 8 



ACTION 

Return 
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remove 



remove 



NAME : 



remove * erase the indicated Dortion of the picture 
and remove the associated element block 
from the disolay list 

SYNOPSIS : 



removeCnum, "elel","ele2 "elelO")? 

int num: PIC / 00 all elements 

1 - 10 soecified elements 

To remove the entire picture! 

remove (PIC); 

To remove element structures: 

remove(num,"e!el">" e 1 e<? ">..); 
DESCRIPTION: 



The entire picture^ or every occurrence of the named 
elements are erased from the vector general disolay 
screen. Each named element structure will be removed 
from the disolay list. The routine removes all occu* 
ranees of the specified elements including elements 
constructed with the eooyeleO routine. 

To redisplay any portion of the removed picture re- 
quires that the user rebuild each element and relink 
it to the aoorooriate objects. 

The parameter 'num' specifies the number of element 
names being passed in this routine and may vary from 1 
to 10. 



DIAGNOSTICS ! 



All errors will be printed on the PDP-11 terminal 
screen. 



ERROR CAUSE 

E-b Specified element does not 
exist 

E-18 Parameter 'num' not 1 to 10 



ACTION 

Skip 

e 1 ement 
num = 1 0 



ALSO SEE: 



erase > 



display 



rotate 



rotate 



NAME : 



rotate - rotate an object 



SYNOPSIS : 

rotate! "objnaire",xradians>yradians [»zradians] ) ; 
float xradi ans^vradians/zradi ans; 



DESCRIPTION: 

The named object will be rotated about the x, v* z 
coordinate axis. The parameters. given in radian meas- 
urer SDecify the degree of rotation desired about each 
axis. 

The z parameter is reaui red only when the coordinate 
system is defined as three dimensional and will oe 
ignored otherwise. 



DIAGNOSTICS: 

All errors will be printed on the PDP-11 terminal 



screen. 






ERROR 


CAUSE 


ACTION 


E-5 


Specified objname does not 
exist 


Return 
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scale 



scale 



NAME : 



scale - modify object scale 



SYNOPSIS : 

scale(”objname"f scale); 
float scale: 0.0 to 1.0 



DESCRIPTION: 

All elements associated with the named object are 
scaled by the value scale at display time. The range 
of scale is from zero to one. Normal or default ob- 
ject scaling corresponds to sc a 1 e ( "ob j name " > 1 . 0 ) . 



DIAGNOSTICS: 



All errors will be 


printed on the 


PDP-11 terminal 


screen. 

ERROR 

E-5 


CAUSE 
S p e c i f i e d 


ob j name 


does not 


ACTION 

Return 


E-30 


e x i s t 
Paramet e r 


'scale' 


not 0.0 to 


1.0 Return 



ALSO SEE: 

oscale 
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setvector 



setvector 



NAME : 



setvector - specify the vector tyoe and vector mode 



SYNOPSIS: 



se t vec t o r ( v t y ce , vmode l/inc) t/scalel ); 



i nt vtyoe : 

V R 
VRX 
VRY 
VRZ 

V A 
VAX 

V AY 
VAZ 

I NC2 
INCX 
INCY 
INC3 



vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 
vec tor 
vector 
vec tor 
vec tor 



relative 
relative 
relative 
relative 
absolute 
absolute 
absolute 
ab so 1 u t e 
incremental 
i ncremental 
i ncremental 
i ncrementa 1 



au t o- i nc remen t x 
auto* increment y 
au t o- i nc remen t z 



aut o- i nc remen t x 
auto* increment y 
auto-increment z 

2- dimensional 
auto- increment 
auto- increment 

3- dimensional 



i n t vmode: 
LN 



1 00 - line 

DSH / 020 - dashed line 
00T / 040 - dotted line 
PNT / 060 - end point 
00 /0120 - da s h -do t -da s h 

ODD /0140 - dash-dot -dash 



line 

line 



float scale: 

MG / 128.0 



NMG / 0.0 



add the coordinate increments 
to the high order bits of the 
specified register, 
add the coordinate increments 
to the low order bits of the 
specified register. 



float i ncl 



DESCRIPTION: 



This routine specifies which one of the 12 vector 
tyoes is to be drawn in the line/ move/ circle and arc 
instructions which follow. It also specifies the vec- 
tor mode ( i . e • / line/ dotted/ dashed/ etc.)/ and if 
reguired/ the increment value for au t o- i nc remen t vec- 
tors and the scale factor for incremental vectors. 
The coordinate values passed in the following draw 
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setvector 



setvector 



instructions are deoenaent on the vector tvoe selected 
in this routine* 

This must follow a draweleO call and oreceed any draw 
instructions* This routine can be called any number of 
times within a draw element block. 

The bracketed z oarameters are required only when the 
coordinate system has been defined as three dimension- 
a 1 . 



All errors will be printed on the PDP-11 terminal 
sc r een . 



DIAGNOSTICS 



ERROR CAUSE 

E-l Routine has been called 

outside a drawel e( ) block 
E - 2 No space available in 
display list 

E-10 Improper vector mode 

E-14 Improper vector tyoe 

E-15 Specified xinc out-of-bounds 



ACTION 

Return 



Return 



vmoae - LN 
vtype = V A 
xinc = x m i n 



or x ma x 



E-lo Specified yinc out-of-bounds 



or 0.0 
yinc = y m i n 



or y m a x 
or 0.0 



E-17 Specified zinc out-of-bounds 



zinc - zmin 
or zmax 



or 0.0 
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setvector - V A 



setvector - VA 



NAME : 



VA - vector absolute 
SYNOPSIS: 

drawel e( H el ename") ; 



setvector(VA/vmode ) > 

mo ve ( c oo rd x , c oo rdv t/coordzl ); 

1 i ne (coorax , coordv (,coordz) )/ 

c i rc 1 e ( d i r , cen t x , c en t y [>centzl )» 

arc (di r,c?nt *»centy (,centzl,endx,endy [ , e n d z ] ) 



ende 1 e ( ) ? 

float coord*f coordy»coordz; 

float cent x,centy/cent Z;endx»endyf ertdz; 



DESCRIPTION: 

The x,y,z coordinates of absolute vectors are speci- 
f i ed with respect to the origin, or zero position of 
the user defined coordinate system. Each x, y, z coor- 
dinate value references a unique point on the display 
screen. Under this vector type, coordinate parameters 
for move/ 1 i ne/arc/c i rc 1 e commands which fall outside 
the defined coordinate system will assume a value of 
the nearest coordinate within the defined system. 



DIAGNOSTICS: 

All errors will be printed on the PDP-11 terminal 



screen. 

ERROR 


CAUSE 


ACTION 




E - 1 


Routine has been called 


Return 




nj 

• 

UJ 


outsice a draweleO block 
No soace available in 


Return 




E - 1 0 


d i s o 1 a y list 
Improper vector mode 


vmode - 


LN 


E - 1 a 


Improper vector type 


v t ype = 


VA 
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set vec tor - VAX 



set vec tor 



VAX 



NAME : 



VAX 



vector absolute au t o- i nc remen t x 



SYNOPSIS : 

drawe1e("e)ename ") f 



setvector(VAX,vmode, xinc) » 
no v e ( c oo r a v [»coordzl ); 
line(cooray 1/coordzi ); 
ci rcletdi r,centy t/centzl ) ; 
arc(dir,centy [»centz) >endy [>enazl ); 



ende ) e ( ) ; 

float xinc»coordy»coordz? 
float c en t y / c en t z / endy / end z ; 



DESCRIPTION: 

The vector absolute aut o- i nc remen t x causes the ini- 
tial x coordinate value to be incremented or decre- 
mented by the value SDecified by 'xinc'. With every 
mo v e/ 1 i ne / a rc /c i rc 1 e command the specified v and z 
coordinate values are undated while the x coordinate 
value is incremented by the constant value 'xinc'. 
For examole/ the ooint ( x / y , z) becomes point (x + xinc/ 
coordy , coordz ) . Under this vector tyoe/ coordinate 
parameters for move/line/arc/circle commands which 
fall outside the defined coordinate system will assume 
a value of tne nearest coordinate within the defined 
system. 

A 'xinc' parameter exceeding one-half the coordinate 
range will be set to zero. 

DIAGNOSTICS: 

All errors will be printed on the PDP-11 terminal 
screen. 

ERROR CAUSE ACTION 

E-l Routine has been called Return 

outs ice a drawel e( ) block 
E-2 No space available in Return 

display list 



1 75 



set vec tor - VAX 



set vector -VAX 



E-10 Improcer vector mode 

E-14 Imorooer vector tyoe 

E — 1 5 Soecified 'xinc* out-of-bounds 



vmoae = LN 
v t ype - V A 
xinc ” 0.0 
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setvector 



setvector - VAY 



- VAY 



NAME : 



VAY 



vector absolute au t o- i nc remen t y 



SYNOPSIS: 

drawel e( "el ename") ; 



setvector(VAY,vmode/yinc) 7 

fiovetcoorox l/coordzl )? 

lineCcoordx l/Coordzl ); 

ci rc 1 e(di r,centx [»centzl ) 7 

arc(di r/centx [»centz]>endx ! ( endzl ) 7 



ende 1 e ( ) J 

float y i nc / coo r dx r c oo r dz 7 
float c en t x , c en t z , end* > endz 7 



DESCRIPTION: 

The vector absolute auto- increment y causes the ini- 
tial y coordinate value to be incremented or decre- 
mented by the value soecified by 'yinc ' . with every 
move/line/arc/circle command the soecified x and z 
coordinate values are ucdated while the y coordinate 
value is incremented by the constant value 'yinc'. 
For example^ the point (x,y,z) becomes the point 
( c oo rdx , y + y i nc / c oo rdz ) . Under this vector tyoe> coor- 
dinate parameters for move/1 ine/arc/ci rcle commands 
which fall outside the defined coordinate system will 
assume a value of the nearest coordinate within the 
de f i ned system. 

A 'yinc' parameter exceeding one-half the coordinate 
range will be set to zero. 

DIAGNOSTICS: 

All errors will be printed on the PDP-11 terminal 
screen. 

ERROR CAUSE ACTION 

E-l Routine has been called Return 

outside a drawel e( ) block 
E-2 No space available in Return 

display list 



177 



se t vec t o r 



VAY 



setvector 



VAY 



E-10 • 

E-14 

E-lb 



Improper vector mode 
Improper vector type 
Specified 'yinc' out-of-bounds 



vmode = LN 
vtype = V A 
y i nc = 0.0 



178 



setvector - VAZ 



setvector 



VAZ 



NAME : 



VAZ - vector absolute au t o- i nc remen t z 
SYNOPSIS: 

drawele("elename")/ 



setvector ( V A l , vmode» z i nc ) » 
move(coorcx/Coordy) ; 

1 ine(coorox,coordy) ; 

c i rcleCdi r,cent*/centy)l 

arc(di r/centx/centy/endx/endy) ! 



ende 1 e ( ) ; 

float zinc/coordx/coordyj 
float c en t x , c en t y > ena x / endy J 



DESCRIPTION: 

The vector absolute auto- i nc rement z causes the ini- 
tial z coordinate value to be incremented or decre- 
mented by the value specified by 'zinc', with every 
move/ 1 i ne/arc/c i rc 1 e command the specified x and y 
coordinate values are updated while the z coordinate 
value is incremented by the constant value 'zinc'. 
For example/ the ooint ( x / y / z ) becomes the point 
(coordx/coory/z+zinc). Under this vector type/ coor- 
dinate parameters for move/1 ine/arc/ci rcle commands 
which fall outside the defined coordinate system will 
assume a value of the nearest coordinate within tne 
defined system. 

A 'zinc' parameter exceeding one-half the coordinate 
range will be set to zero. 

DIAGNOSTICS: 

All errors will oe printed on the PDP-11 terminal 
screen. 

ERROR CAUSE ACTION 

E-l Routine has been called Return 

outside a draweleC) block 
E-2 No space available in Return 

display list 
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set vec tor - VAZ 



setvector 



VAZ 



E-l 0 
E-ia 
E-17 



Improper vector mode 
Improper vector type 
Specified 'zinc' ou t -o f -bounds 



vmode = LN 
vtvoe = VA 
zinc = 0.0 
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setvector - VR 



setvector 



VR 



NAME: VR - vector relative 
SYNOPSIS: 

draweleCelename") } 



setvector(VRfvmode) ; 

mo ve (de 1 t ax / de 1 t ay (/deltazl ); 

1ine(deltax,deltay (»del taz) ) ; 

c i r c 1 e ( d i r / cen t x , c en t y [» centzl ); 

arc(di r»centx,centy (Kentzl >endx,endy [»endzl )t 



endel e ( ) ; 

float de 1 t a x , ae 1 t ay » de 1 t az ; 

float centx,centy*centz/endx,endy/endz; 



DESCRIPTION: 

Relative vectors soecify an increment value that is to 
be added to or subtracted from the initial x,y,z beam 
oosition. For example/ the point (x,y,z) becomes 
point (x+del tax/y + del tay»z+de1taz) . 

Under this vector type/ coordinate parameters for 
move/ 1 i ne/a rc /c i rc 1 e commands which exceed one-half 
the coordinate range will be set to zero. 



DIAGNOSTICS: 



All errors will be printed on the PDP-11 terminal 
screen. 



ERROR 
E - 1 


CAUSE 

Routine 


has been cal led 


ACTION 

Return 




E-2 


within a 
No space 


draweleO block 
available in 


Return 




E-l 0 


display 
I mp rope r 


list 

vector mode 


vmode = 


IN 


E-14 


Improper 


vector tyoe 


v t y pe - 


VA 
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set vec tor - VRX 



setvector 



VRX 



NAME : 



VRX - vector relative auto*i nc recent x 
SYNOPSIS: 

drawele("elename")/ 



setvector(VRX,vmode/ x i nc) 
moveCdeltay t/deltaz) ); 
line(deltay (/deltaz) ) ; 
c i rc 1 e ( d i r , cen t y f/Centz) ); 
arc (di r /Centy l»centzl <endy Uendz) ); 
• 

endeleO »' 

float xinc/deltay/deltaz? 

float c en t y / cen t z » endy / endz ; 



DESCRIPTION: 

A vector relative auto- increment x causes the initial 
x coordinate value to be incremented or decremented bv 
the constant value ' x i n c ' . With every move/line/arc/ 
circle instruction that follows/ the y and z coordi- 
nate values will be uodated/ while x is steeped by the 
value ' x i nc ' . For example/ the point (x/y/Z) becomes 
the point ( x + x i nc / y +de 1 t ay / z +de 1 t az ) . 

Under this vector type/ cooroinate parameters for 
move/line/arc/circle commands which exceed one-half 
the coordinate range will be set to zero. 



DIAGNOSTICS: 



All errors will be printed on the PDP-11 terminal 
screen. 



ERROR 


CAUSE 


ACTION 




E - 1 


Routine has been called 
outside a drawel e( ) block 


Return 




E-2 


No space available in 
display list 


Return 




E - 1 0 


Improper vector mode 


vmode - 


LN 


E-14 


Improper vector type 


v t y pe = 


V A 


E - 1 5 


Specified 'xinc' out-of-bounds 


xinc = 


o 

« 

o 



182 



setvector - VRY 



setvector - VRY 



NAME : 



VRY 



vector relative auto'increment y 



SYNOPSIS: 

drawel e ( "e 1 ename " ) ; 



setvector(VRY, vmooe» yi nc) 
novetdel tax 1/deltazl ); 
line(deltax l/deltazl ); 
circle(dir,centx f / c e n t z 3 ) ; 

arc(dir/centx 1/centzl/endx l,enazl ); 



ende 1 e ( ) ; 

float yinc/deltax/deltaz? 
float cent x , cent z / endx , endz J 



DESCRIPTION: 

A vector relative auto- increment y causes the initial 
y coordinate value to be incremented or decremented by 
the constant value ' y i n c ’ • rtith every move/line/arc/ 
circle instruction that follows/ the x and z coordi- 
nate values will be updated/ while y is incremented by 
the value 'vine'. For example/ the point (x/y/Z) 
becomes the point ( x tde 1 t a x / y + y i nc / z + de 1 t az ) . 

Under this vector type/ coordinate parameters for 
mo v e / 1 i ne / a r c /c i r c 1 e commands which exceed one-half 
the coordinate ranoe will be set to zero. 



DIAGNOSTICS: 



All errors will be printed on the PDP-11 terminal 
screen. 



ERROR 


CAUSE 


ACTION 




E-l 


Routine has been called 
outsiae a dr a w e 1 e ( ) block 


Return 




E-2 


space available in 
display list 


Return 




E-l 0 


Improper vector mode 


vmode = 


LN 


E-l a 


Improper vector type 


v t y pe = 


VA 


E-16 


Specified •yinc* out-of-bounds 


y i nc = 


o 

• 

o 
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set vec tor - VRZ 



setvector 



VRZ 



NAME : 



VRZ - vector relative auto* increment z 
SYNOPSIS: 

drawele( M elename") ; 



setvector(VPZ; vmode» zi nc) 
move ( de 1 tax, del tay) ; 

1 ineCdel tax, del tay); 

ci rcl e(di r,centx,centy) ; 

arc(di r,centx,centy,endx,endy) ; 



ende 1 e ( ) ? 

float z i nc , de 1 t ax , de 1 t ay ; 
float cen t x , cent y , enox , endy ; 



DESCRIPTION: 

A vector relative auto- increment z causes the initial 
z coordinate value to be incremented or decremented by 
the constant value 'zinc'. with every move/ 1 i ne/a rc / 
circle instruction that follows, the x and y coordi- 
nate values will be undated, while z is incremented by 
the value 'zinc'. For examole, the point (x,y,z) 
becomes the point (x+del tax , y+del tay , z + i ncz) . 

Under this vector type, coordinate parameters for 
move/line/arc/circle commands which exceed one-half 
the coordinate range will be set to zero. 



DIAGNOSTICS: 



All errors will be printed on the PDP-11 terminal 
screen. 



ERROR 


CAUSE 


ACTION 




E-l 


Routine has been called 
outside a draweleO block 


Return 




E-2 


No soace available in 
d i s o 1 a y list 


Re t urn 




E-l 0 


Improper vector mode 


vmoae - 


LN 


E-i y 


Improper vector type 


vtyoe = 


VA 


e-i 7 


Specified ’zinc* ou t -o f -Pounds 


zinc - 


0 . 0 



setvector - I NC2 



setvector 



INC2 



NAME : 



INC2 - incremental vector? t wo-d i mens i ona 1 
SYNOPSIS: 



drawel e ( "el ename") ? 



setvector(INC2/vmode^scale)? 
move(del t ax , de 1 tay) ? 

1 ineCdel tax, del tay) ? 



enoe 1 e ( ) ? 



float de 1 t ax , ae 1 t ay ? 



float 


scale: 






MG 


/ 128.0 - 


add the coordinate increments 
the 7 high order bits of the 
specified register. 


t o 


NMG 


/ 0.0 


add the coordinate increments 
the 7 low order bits of the 
specified register. 


t 0 


DESCRIPTION: 


A two- 


dimensional 


relative vector that halves 


vector 



storage reaui rements and doubles the data rate. This 
vector tyoe should be used when element storage soace 
is critical. This reduced storage reauirement results 
from a limitation on the maximum size of each relative 
increment. The values passed in move/line instructions 
are limited to approximately 3 % of the user minimum 
and maximum coordinate ranges. Should coordinate 
parameters for move/line commands exceed the 3% limit, 
they will oe reduced to satisfy the constraint. 

The parameter 'scale' specifies whether this increment 
value shoula be added to the 7 high order bits of tne 
specified coordinate or to the 7 low order bits. This 
scale factor then determines if the increments will be 
applied over a fine(NMG) or coarse(MG) grid. 

Arcs ana circles cannot be drawn with this vector 
type. 
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set vec tor 



I NC2 



setvector - I N C 2 



DIAGNOSTICS : 

All errors will be orinted on the PDP*11 terminal 
screen. 



ERROR 
E - 1 


CAUSE ACTION 
Routine has been called Return 
outs ice a draweleO block 


E-2 


No space available in Return 


E-l a 


d i s d 1 a y list 

Improoer vector type vtype = VA 
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setvector 



INC 3 



setvector - INC3 



NAME : 



INC3 - incremental vector# three~dimensional 
SYNOPSIS : 



drawel e( "el ename") ; 



setvector! INCX , vmode , seal e ) 7 
moveCdel tax, del t ay ,de 1 taz) ; 

1 ineCdel tax, del t ay , de 1 taz); 



ende 1 e ( ) ; 



float 


del tax, del t ay , de 1 taz; 






float 


scale: 








MG 


/ 


128.0 - add 


the coo rd i na t e 


increments 


t 0 






the 


7 high order bi 


t s of the 








soecified register. 






NMG 


/ 


0.0 - add 


the coordinate 


increments 


t 0 






the 


7 low order bit 


s of the 








soecified register. 







DESCRIPTION: 

A three-dimensional relative vector that halves vector 
storage requirements and doubles the data rate. This 
vector type should be used when element storage space 
is critical. This reduced storaae requirement results 
from a limitation on the maximum size of each relative 
increment. The values passed in move/line instructions 
are limited to approximately 3% of the user minimum 
and maximum coordinate ranqes. Should coordinate 
parameters for move/line commands exceed the 3% limit, 
they will be reduced to satisfy the constraint. 

The parameter 'scale' specifies whether this increment 
value should be added to the 7 high oroer pits of the 
specified coordinate or to the 7 low oroer bits. This 
scale factor then determines if the increments will be 
applied over a fine(NMG) or coarse ( M G) grid. 

Arcs and circles cannot be drawn with this vector 
tvpe. 
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set vec tor 



INC3 



setvector 



I NC 3 



DIAGNOSTICS: 



All errors will be printed on the PDP-11 terminal 
screen. 



ERROR 


CAUSE 


E-l 


Routine has been called 
outsiae a draweleO block 


rvj 

l 

LU 


No soace available in 
display list 


E-ia 


Improper vector type 



ACTION 

Return 

Return 

vtype = VA 



188 



setvector 



INCX 



setvector - INCX 



NAME : 



INCX - incremental vector? two-dimensional 
au t o- i nc remen t x 



SYNOPSIS: 



drawele("elename") ? 



set vector ( INCX, vmode^ x inc ; seal e) » 
move ( de 1 t ay » de 1 tav) ? 

1 ine(deltay,deltay); 



enae 1 e ( ) ? 

float xinc,deltay? 
float scale: 

MG / 128.0 - add the coordinate increments to 

the 7 high order bits of the 
specified register. 

MMG / 0.0 - add the coordinate increments to 

the 7 low order bits of the 
specified register. 



DESCRIPTION: 

A two-dimensional relative vector that halves vector 
storaae requirements and doubles the data rate. This 
vector type should be used when element storage space 
is critical. This reduced storage requirement results 
from a limitation on the maximum size of each relative 
increment. The values passed in move/line instructions 
are limited to apo ro x i ma t e 1 y 3% of the user minimum 
and maximum coordinate ranges. Should the coordinate 
parameters for move/line commands exceed the 3% limit, 
they will be reduced to satisfy the constraint. 

The parameter 'scale' specifies whether this increment 
value should be added to the 7 high order bits of the 
specified coordinate or to the 7 low order bits. This 
scale factor then determines if the increments will be 
applied over a fine(NMG) or coarse(MG) arid. 

This incremental, auto- increment vector causes the x 
coordinate value to be incremented or decremented by 
the constant value ' xi nc ' , while the y coordinate 
value is increment by small relative values. The 
'xinc' value need not be limited to 3% of the 
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set vec tor 



INCX 



setvector 



INCX 



coordinate range but may not exceed one-half the coor- 
dinate range or it will be set to zero. 

Arcs and circles cannot be drawn with this vector 
tvoe. 



DIAGNOSTICS: 



All errors will be printed on the P D P - 


11 termi na 


screen. 








ERROR 


CAUSE 


ACTION 




E - 1 


Routine has been called 
outside a araweleO block 


Return 




E-2 


No space available in 
display list 


Return 




E-t a 


Improper vector tyoe 


v t ype = 


V A 


E - 1 5 


Specified 1 xinc 1 out -of -bounds 


x i nc - 


o 

• 

o 
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setvector 



INCY 



setvector 



INCY 



NAME : 



INCY - incremental vector? two-dimensional 
auto-increment y 



SYNOPSIS: 



drawel e( M elename") / 



setvector! INCY , vmode/yi nc /Seal e) ) 
moveCdel tax/del tax) ; 
line(deltax,deltax); 



endeleO! 



float yinc/deltax? 



float 


scale: 






MG 


/ 


129.0 


- ado the coordinate increments 
the 7 high order bits of the 
specified register. 


t 0 


NMG 


/ 


O 

• 

o 


- add the coordinate increments 
the 7 low order bits of the 
soecified register. 


t 0 



DESCRIPTION: 

A two-dimensional relative vector that halves vector 
storage requirements and doubles the data rate. This 
vector type should be used when element storage space 
is critical. This reduced storage requirement results 
from a limitation on the maximum size of each relative 
increment. The values passed in move/line instructions 
are limited to aop r ox i ma t e 1 y 3% of the user minimum 
and maximum coordinate ranges. Should the coordinate 
parameters of move/line commands exceed the 3% limit/ 
they will be reduced to satisfy the constraint. 

The parameter 'scale' specifies whether this increment 
value should be added to the 7 high order bits of the 
specified coordinate or to the 7 low order bits. 
This scale factor then determines if the increments 
will be applied over a fine(NMG) or coarse(MG) qria. 

This incremental/ auto-increment vector causes the y 
coordinate value to be incremented or decremented by 
the constant value 'yinc '/ while the x coordinate 
value is increment by small relative values. The 
'yinc' value need not be limited to 3% of tne 
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set vec t o r 



INCY 



setvector 



INCY 



coordinate range but may not exceed one-half the coor- 
dinate range or it will be set to zero. 

Arcs and circles cannot De drawn with this vector 
t ype • 



DIAGNOSTICS: 



All errors will be printed on the PDP-11 terminal 
screen. 



ERROR CAUSE 

E-l Routine has been called 

outside a draweleO block 
E-2 No space available in 

d i so 1 ay list 

E-l a Improoer vector type 

E-16 Soecified 'yinc' out-of-bounds 



ACTION 

Return 

Return 

vtype = V A 
y i nc r 0.0 



S v s i n i t 



sys i n 1 t 



NAME : 



s y s i n i t - vector general disolay initialization 



SYNOPSIS: 

SySini t (devnum); 
i n t devnum : 0 o r 1 



DESCRIPTION: 

This routine establishes a link with the vector gen- 
eral/ initializes its display system and sets all the 
user default oarameters. The routine allows for 
specification of which VG device the user desires to 
utilize. The VG devices are numbered 0 and 1. Should 
the system be unable to allocate the specified VG dev- 
ice/ allocation of the other VG device will be a t - 
temoted. 

This routine must be called before any other display 
inst rue t i ons . 



DIAGNOSTICS: 

If initialization of the specified VG device cannot be 
completed/ an error message will be printed out and 
the system will attempt to initialize the other VG 
device. The system will terminate the process only if 
both initialization attempts fail. 

All errors will be printed on the PDP-11 terminal 



screen. 






ERROR 

E-27 


CAUSE 

Improper VG devnum specified 


ACTION 
devnum = 0 
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t r ans 



trans 



NAME : 



trans - translate object 



SYNOPSIS : 

t rans("ob jname"/del tax ,del t ay (/del tazl ); 
float de 1 t ax / de 1 t ay / de 1 t az / 



DESCRIPTION: 

All of the elements associated with the named object 
are translatec from their present location (X,Y/Z) to 
(X+del tax/Y+del t ay / Z + de 1 taz) . 

The z parameter is reoui red only when the coordinate 
system is defined as three dimensional/ and will be 
ignored if included under a two-dimensional system. 



DIAGNOSTICS: 

All errors will be printed on the PDP-11 terminal 



sc r een . 

ERROR 

E-5 


CAUSE 
Spec i f i ed 


object 


does not 


ACTION 

Return 




E - 1 5 


exist 
Soec i tied 


de 1 t a x 


out -of -bounas 


de 1 t a x = 


O 

• 

o 


E - 1 6 


Spec i f i ed 


del t ay 


ou t -o f -bounds 


de 1 t ay = 


o 

• 

o 


E - 1 7 


Spec i f i ea 


del taz 


out -of -bounas 


de 1 t a z - 


o 

• 

o 



ALSO SEE: 

offset/ place 
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vqd icture 



vgpicture 



NAME : 



vqoicture ~ start refresh of VG picture display 



SYNOPSIS : 

vgp i c t u r e ( ) ; 



DESCRIPTION: 



This routine n>ust oe called to initiate 
elements on the VG display screen. The 
be called only once. The display!) 
called after this routine to activate 
the display of all or parts of the display picture. 



the display of 
rout i ne need 
rout i ne may be 
o r deac t i v a t e 



DIAGNOSTICS: 

none 



ALSO SEE: 

display, erase, remove 
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vg t e rm 



vqt e rm 



NAME : 



vaterm terminate display and close VG device 



SYNOPSIS: 

vg t e rm ( ) ; 



DESCRIPTION: 

This routine should be included at the end of 
user's program to properly terminate the display 
close the VG device* Should the user’s program 
tain an endless loop/ depressing the 1 rubout 1 key 
accomplish the same task. 



DIAGNOSTICS: 

none 



the 

and 

con- 

will 
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